Method: projects.databases.documents.createDocument

Erstellt ein neues Dokument.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource. Beispiel: projects/{projectId}/databases/{databaseId}/documents oder projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

Erforderlich. Die Sammlungs-ID, relativ zu parent, die aufgelistet werden soll. Beispiel: chatrooms

Abfrageparameter

Parameter
documentId

string

Die vom Kunden zugewiesene Dokument-ID, die für dieses Dokument verwendet werden soll.

Optional. Wenn keine Angabe erfolgt, wird vom Dienst eine ID zugewiesen.

mask

object (DocumentMask)

Die zurückzugebenden Felder. Wenn nicht festgelegt, werden alle Felder zurückgegeben.

Wenn das Dokument ein Feld enthält, das in dieser Maske nicht vorhanden ist, wird dieses Feld nicht in der Antwort zurückgegeben.

Anfragetext

Der Anfragetext enthält eine Instanz von Document.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Document.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.