Method: projects.databases.importDocuments

Mengimpor dokumen ke Google Cloud Firestore. Dokumen yang ada dengan nama yang sama akan ditimpa. Impor terjadi di latar belakang dan progresnya dapat dipantau serta dikelola melalui resource Operasi yang dibuat. Jika operasi database.importDocuments dibatalkan, kemungkinan sebagian data tersebut telah diimpor ke Cloud Firestore.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Database yang akan diimpor. Harus dalam format: projects/{projectId}/databases/{databaseId}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
Kolom
collectionIds[]

string

ID koleksi yang akan diimpor. Tidak ditentukan berarti semua koleksi yang disertakan dalam impor.

inputUriPrefix

string

Lokasi file yang diekspor. Ini harus cocok dengan outputUriPrefix dari ExportDocumentsResponse dari ekspor yang telah berhasil diselesaikan. Lihat: google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.