Method: projects.databases.documents.createDocument

Crée un nouveau document.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC .

Paramètres du chemin

Paramètres
parent

string

Requis. La ressource parent. Par exemple : projects/{projectId}/databases/{databaseId}/documents ou projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

Requis. L'ID de collection, relatif au parent , à répertorier. Par exemple : chatrooms .

Paramètres de requête

Paramètres
documentId

string

ID de document attribué par le client à utiliser pour ce document.

Facultatif. S’il n’est pas précisé, un identifiant sera attribué par le service.

mask

object ( DocumentMask )

Les champs à retourner. S’il n’est pas défini, renvoie tous les champs.

Si le document comporte un champ qui n'est pas présent dans ce masque, ce champ ne sera pas renvoyé dans la réponse.

Corps de la demande

Le corps de la requête contient une instance de Document .

Corps de réponse

En cas de succès, le corps de la réponse contient une instance de Document .

Portées des autorisations

Nécessite l'une des étendues OAuth suivantes :

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

Pour plus d'informations, consultez la Présentation de l'authentification .