Method: projects.beginTransaction

Begins a new transaction.

HTTP request

POST https://datastore.googleapis.com/v1/projects/{projectId}:beginTransaction

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. The ID of the project against which to make the request.

Request body

The request body contains data with the following structure:

JSON representation
{
  "databaseId": string,
  "transactionOptions": {
    object (TransactionOptions)
  }
}
Fields
databaseId

string

The ID of the database against which to make the request.

'(default)' is not allowed; please use empty string '' to refer the default database.

transactionOptions

object (TransactionOptions)

Options for a new transaction.

Response body

The response for Datastore.BeginTransaction.

If successful, the response body contains data with the following structure:

JSON representation
{
  "transaction": string
}
Fields
transaction

string (bytes format)

The transaction identifier (always present).

A base64-encoded string.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.