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 个写入结果对应于请求中的第 i 个写入。

commitTime

string (Timestamp format)

提交发生的时间。使用等于或更大的 readTime 执行的任何读取操作都一定会看到提交的效果。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"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

如需了解详情,请参阅身份验证概览