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
|
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 (
|
| Fields | |
|---|---|
databaseId
|
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
|
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
|
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 .

