Method: projects.databases.documents.commit

Esegue il commit di una transazione e, facoltativamente, aggiorna i documenti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
database

string

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

object (Write)

Le operazioni di scrittura da applicare.

Esegui sempre a livello atomico e in ordine.

transaction

string (bytes format)

Se impostato, applica tutte le scritture in questa transazione ed 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-th corrisponde alla scrittura i-esima nella richiesta.

commitTime

string (Timestamp format)

L'ora in cui si è verificato il commit. Qualsiasi lettura con un valore readTime uguale o maggiore è garantito per vedere gli effetti del commit.

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.