Method: projects.databases.documents.commit

修訂交易，並視需要更新文件。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
database

string

必要欄位。資料庫名稱。請採用下列格式：projects/{projectId}/databases/{databaseId}。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
欄位
writes[]

object (Write)

要套用的寫入內容。

一律會依序執行。
transaction

string (bytes format)

如有設定，請套用並修訂這項交易中的所有寫入作業。

Base64 編碼的字串。

回應主體

Firestore.Commit 的回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
欄位
writeResults[]

object (WriteResult)

套用寫入的結果。

這個 i-th 寫入結果對應要求中的第 i 次寫入。
commitTime

string (Timestamp format)

修訂版本發生的時間。只要讀取具有相同或大於 readTime 的讀取作業，就能看到修訂版本的效果。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱驗證總覽。