Method: projects.databases.documents.commit

Confirma una transacción y, opcionalmente, actualiza los documentos.

solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
database

string

Requerido. 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 )

Los escritos para aplicar.

Siempre ejecutado de forma atómica y en orden.

transaction

string ( bytes format)

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

Una cadena codificada en base64.

Cuerpo de respuesta

La respuesta para Firestore.Commit .

Si tiene éxito, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

object ( WriteResult )

El resultado de aplicar las escrituras.

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

commitTime

string ( Timestamp format)

La hora a la que se produjo 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 "Zulu", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z" .

Á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 .