Method: projects.databases.importDocuments

ドキュメントを Google Cloud Firestore にインポートします。同じ名前の既存のドキュメントは上書きされます。インポートはバックグラウンドで行われ、その進行状況は作成されたオペレーション リソースを介してモニタリングおよび管理できます。databases.importDocuments オペレーションがキャンセルされた場合、データのサブセットがすでに Cloud Firestore にインポートされている可能性があります。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

詳細については、認証の概要をご覧ください。