Method: projects.databases.importDocuments

這個外掛程式能將文件匯入 Google Cloud Firestore。名稱相同的現有文件會遭到覆寫。匯入作業會在背景中執行，您可以透過已建立的 Operation 資源來監控及管理進度。如果 Database.importDocuments 作業已取消，可能是部分資料已匯入 Cloud Firestore。

HTTP 要求

POST https://firestore.googleapis.com/v1beta2/{name=projects/*/databases/*}:importDocuments

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

路徑參數

參數
name

string

要匯入的資料庫。格式應為 projects/{projectId}/databases/{databaseId}。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
欄位
collectionIds[]

string

要匯入的集合 ID。「未指定」表示匯入作業中的所有集合。
inputUriPrefix

string

匯出檔案的位置。這必須與已成功匯出的 ExportDocumentsResponse 的 outputUriPrefix 相符。請參閱：google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix。

回應主體

如果成功，回應主體會包含 Operation 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱驗證總覽。