Method: projects.databases.documents.commit

Xác nhận giao dịch, trong khi không bắt buộc cập nhật tài liệu.

yêu cầu HTTP

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

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 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Trường
writes[]

object (Write)

Các quyền cần ghi để áp dụng.

Luôn thực thi tỉ mỉ và theo thứ tự.
transaction

string (bytes format)

Nếu được đặt, sẽ áp dụng tất cả các lượt ghi trong giao dịch này và cam kết.

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

Nội dung phản hồi

Phản hồi cho Firestore.Commit.

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 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Trường
writeResults[]

object (WriteResult)

Kết quả của việc áp dụng hoạt động ghi.

Kết quả ghi thứ i này tương ứng với lần ghi thứ i trong yêu cầu.
commitTime

string (Timestamp format)

Thời gian thực hiện cam kết. Bất kỳ lượt đọc nào có readTime bằng hoặc lớn hơn đều đảm bảo thấy được hiệu quả của lệnh xác nhận.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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.