Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Método: 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

Necesario. El nombre de la base de datos. En el formato: projects/{project_id}/databases/{database_id} .

Cuerpo de solicitud

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

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

object ( Write )

El escribe para aplicar.

Siempre ejecutado atómicamente y en orden.

transaction

string ( bytes format)

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

Una cadena codificada en base64.

Cuerpo de respuesta

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

La respuesta para Firestore.Commit .

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

object ( WriteResult )

El resultado de aplicar las escrituras.

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

commitTime

string ( Timestamp format)

La hora en que se produjo el compromiso. Cualquier lectura con una igual o mayor readTime está garantizado para 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 fraccionales. 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 la Descripción general de la autenticación .