Method: projects.databases.documents.beginTransaction

Startet eine neue Transaktion.

HTTP-Anfrage

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

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
{
  "options": {
    object (TransactionOptions)
  }
}
Felder
options

object ( TransactionOptions )

Die Optionen für die Transaktion. Standardmäßig handelt es sich um eine Lese-/Schreibtransaktion.

Antwortkörper

Die Antwort für Firestore.BeginTransaction .

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

JSON-Darstellung
{
  "transaction": string
}
Felder
transaction

string ( bytes format)

Die Transaktion, die gestartet wurde.

Eine Base64-codierte Zeichenfolge.

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 .