Method: projects.databases.documents.createDocument

建立新文件。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。父項資源。例如 projects/{projectId}/databases/{databaseId}/documents 或 projects/{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

詳情請參閱驗證總覽。