Method: projects.databases.documents.createDocument

Crea un documento nuevo.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El recurso superior Por ejemplo, projects/{projectId}/databases/{databaseId}/documents o projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}.

collectionId

string

Obligatorio. El ID de colección, en relación con parent, para la lista. Por ejemplo: chatrooms.

Parámetros de consulta

Parámetros
documentId

string

El ID de documento asignado por el cliente que se usará en este documento.

Opcional. Si no se especifica, el servicio asignará un ID.

mask

object (DocumentMask)

Los campos que se deben mostrar. Si no se configura, muestra todos los campos.

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

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Document.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Document.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

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