Method: projects.databases.documents.commit

Confirma una transacción y, de forma opcional, actualiza documentos.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
database

string

Obligatorio. Es el nombre de la base de datos. En el formato: projects/{projectId}/databases/{databaseId}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Campos
writes[]

object (Write)

Las operaciones de escritura que se aplicarán.

Siempre se ejecuta de forma atómica y en orden.
transaction

string (bytes format)

Si se configura, aplica todas las escrituras en esta transacción y la confirma.

String codificada en base64.

Cuerpo de la respuesta

La respuesta para Firestore.Commit.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Campos
writeResults[]

object (WriteResult)

Es el resultado de aplicar las operaciones de escritura.

Este resultado de escritura de i-th corresponde a la escritura de i-ésima en la solicitud.
commitTime

string (Timestamp format)

La hora en la que se realizó la confirmación Se garantiza que cualquier lectura con un readTime igual o mayor verá los efectos de la confirmación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

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.