Method: projects.databases.documents.commit

提交事務,同時可以選擇更新文件。

HTTP請求

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

URL 使用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次寫入結果對應於請求中的第i次寫入。

commitTime

string ( Timestamp format)

提交發生的時間。任何等於或更大readTime讀取都保證能看到提交的效果。

RFC3339 UTC「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

有關詳細信息,請參閱身份驗證概述