Method: projects.databases.documents.createDocument

Crea un nuevo documento.

solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
parent

string

Requerido. El recurso principal. Por ejemplo: projects/{projectId}/databases/{databaseId}/documents o projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

Requerido. El ID de la colección, relativo al parent , para enumerar. Por ejemplo: chatrooms .

Parámetros de consulta

Parámetros
documentId

string

El ID del documento asignado por el cliente que se utilizará para este documento.

Opcional. Si no se especifica, el servicio asignará una identificación.

mask

object ( DocumentMask )

Los campos a devolver. Si no se establece, devuelve todos los campos.

Si el documento tiene un campo que no está presente en esta máscara, ese campo no se devolverá en la respuesta.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Document .

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Document .

Ámbitos de autorización

Requiere uno de los siguientes ámbitos de OAuth:

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

Para obtener más información, consulte Descripción general de la autenticación .