Method: projects.databases.documents.batchWrite
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:batchWrite
网址采用 gRPC 转码语法。
路径参数
参数 |
database |
string
必需。数据库名称。格式为:projects/{projectId}/databases/{databaseId} 。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"writes": [
{
object (Write )
}
],
"labels": {
string: string,
...
}
} |
字段 |
writes[] |
object (Write )
要应用的写入。 该方法不会以原子方式应用写入,也不保证排序。每次写入都会独立成功或失败。针对每个请求,您不能多次向同一文档写入数据。
|
labels |
map (key: string, value: string)
与此批量写入关联的标签。 包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" } 。
|
响应正文
来自 Firestore.BatchWrite
的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"writeResults": [
{
object (WriteResult )
}
],
"status": [
{
object (Status )
}
]
} |
字段 |
writeResults[] |
object (WriteResult )
应用写入的结果。 第 i 个写入结果对应于请求中的第 i 个写入。
|
status[] |
object (Status )
应用写入的状态。 第 i 个写入状态对应于请求中的第 i 个写入。
|
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅身份验证概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-04-12。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]