新建一个文档。
HTTP 请求
POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents/**}/{collectionId}
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。父级资源。例如: |
collectionId |
必需。要列出的集合 ID(相对于 |
查询参数
参数 | |
---|---|
documentId |
客户分配的文档 ID,用于此文档。 可选。如果未指定,服务会分配 ID。 |
mask |
要返回的字段。如果未设置,则返回所有字段。 如果文档中某个字段不在此掩码中,则不会在响应中返回该字段。 |
请求正文
请求正文包含一个 Document
实例。
响应正文
如果成功,则响应正文包含一个 Document
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅身份验证概览。