Method: projects.databases.documents.commit

Führt ein Commit einer Transaktion durch und aktualisiert optional Dokumente.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
database

string

Erforderlich. Der Datenbankname. Im Format: projects/{projectId}/databases/{databaseId}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Felder
writes[]

object (Write)

Die anzuwendenden Schreibvorgänge.

Immer atomar und in der richtigen Reihenfolge ausgeführt.

transaction

string (bytes format)

Wenn festgelegt, werden alle Schreibvorgänge in dieser Transaktion angewendet und ein Commit durchgeführt.

Ein base64-codierter String.

Antworttext

Die Antwort für Firestore.Commit.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Felder
writeResults[]

object (WriteResult)

Das Ergebnis der Anwendung der Schreibvorgänge.

Dieses i-te Schreibergebnis entspricht dem i-ten Schreibvorgang in der Anfrage.

commitTime

string (Timestamp format)

Der Zeitpunkt, zu dem der Commit ausgeführt wurde. Jeder Lesevorgang mit einem gleich oder größer als readTime erkennt die Auswirkungen des Commits garantiert.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.