Method: projects.databases.documents.commit

Esegue il commit di una transazione, aggiornando facoltativamente i documenti.

Richiesta HTTP

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

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri
database

string

Necessario. Il nome del database. Nel formato: projects/{projectId}/databases/{databaseId} .

Richiedi corpo

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Campi
writes[]

object ( Write )

Le scrive per candidarsi.

Sempre eseguito atomicamente e in ordine.

transaction

string ( bytes format)

Se impostato, applica tutte le scritture in questa transazione e ne esegue il commit.

Una stringa con codifica base64.

Corpo della risposta

La risposta per Firestore.Commit .

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Campi
writeResults[]

object ( WriteResult )

Il risultato dell'applicazione delle scritture.

Questo risultato di scrittura i-esima corrisponde alla scrittura i-esima nella richiesta.

commitTime

string ( Timestamp format)

L'ora in cui si è verificato il commit. Qualsiasi lettura con un readTime uguale o maggiore vedrà sicuramente gli effetti del commit.

Un timestamp in formato RFC3339 UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z" .

Ambiti autorizzativi

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, vedere la panoramica sull'autenticazione .