Method: projects.databases.documents.createDocument

Crea un nuovo documento.

Richiesta HTTP

POST https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents/**}/{collectionId}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatoria. La risorsa padre. Ad esempio: projects/{projectId}/databases/{databaseId}/documents o projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

Obbligatoria. L'ID raccolta, relativo a parent, dell'elenco. Ad esempio: chatrooms.

Parametri di ricerca

Parametri
documentId

string

L'ID documento assegnato dal cliente da utilizzare per questo documento.

Campo facoltativo. Se non specificato, il servizio verrà assegnato un ID.

mask

object (DocumentMask)

I campi da restituire. Se non viene configurato, restituisce tutti i campi.

Se il documento ha un campo che non è presente in questa maschera, quel campo non verrà restituito nella risposta.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Document.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Document.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.