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

Tham số
database

string

Bắt buộc. Tên cơ sở dữ liệu. Theo đị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 lựa chọn cho giao dịch. Mặc định là giao dịch đọc-ghi.

Nội dung phản hồi

Câu trả lời cho Firestore.BeginTransaction.

Nếu thành công, phần 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 đã bắt đầu.

Một 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 đây:

  • 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ề hoạt động xác thực.