建立新文件。
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
詳情請參閱驗證總覽。