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 |
Erforderlich. Der Datenbankname. Im Format: |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"writes": [
{
object ( |
Felder | |
---|---|
writes[] |
Die anzuwendenden Schreibvorgänge. Immer atomar und in der richtigen Reihenfolge ausgeführt. |
transaction |
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 ( |
Felder | |
---|---|
writeResults[] |
Das Ergebnis der Anwendung der Schreibvorgänge. Dieses i-te Schreibergebnis entspricht dem i-ten Schreibvorgang in der Anfrage. |
commitTime |
Der Zeitpunkt, zu dem der Commit ausgeführt wurde. Jeder Lesevorgang mit einem gleich oder größer als Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
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.