Method: projects.databases.documents.createDocument

新建一个文档。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。父级资源。例如:projects/{projectId}/databases/{databaseId}/documentsprojects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

必需。要列出的集合 ID(相对于 parent)。例如:chatrooms

查询参数

参数
documentId

string

客户分配的文档 ID,用于此文档。

可选。如果未指定,服务会分配 ID。

mask

object (DocumentMask)

要返回的字段。如果未设置,则返回所有字段。

如果文档中某个字段不在此掩码中,则不会在响应中返回该字段。

请求正文

请求正文包含一个 Document 实例。

响应正文

如果成功,则响应正文包含一个 Document 实例。

授权范围

需要以下 OAuth 范围之一:

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

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