Method: projects.databases.documents.commit

Übernimmt eine Transaktion und aktualisiert optional Dokumente.

HTTP-Anfrage

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

Die URL verwendet die gRPC-Transcoding -Syntax.

Pfadparameter

Parameter
database

string

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

Anforderungstext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object ( Write )

Das schreibt zur Bewerbung.

Immer atomar und in der richtigen Reihenfolge ausgeführt.

transaction

string ( bytes format)

Wenn festgelegt, werden alle Schreibvorgänge in dieser Transaktion angewendet und festgeschrieben.

Eine Base64-codierte Zeichenfolge.

Antwortkörper

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 stattgefunden hat. Bei jedem Lesevorgang mit einer gleichen oder größeren readTime ist garantiert, dass die Auswirkungen des Commits sichtbar werden.

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

Berechtigungsbereiche

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 .