Method: projects.databases.documents.beginTransaction

Bắt đầu một giao dịch mới.

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
database

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{projectId}/databases/{databaseId}.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "options": {
    object (TransactionOptions)
  }
}
Trường
options

object (TransactionOptions)

Các tuỳ chọn cho giao dịch. Mặc định là giao dịch đọc-ghi.

Nội dung phản hồi

Phản hồi cho Firestore.BeginTransaction.

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "transaction": string
}
Trường
transaction

string (bytes format)

Giao dịch đã được bắt đầu.

Chuỗi được mã hoá base64.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.