Method: projects.databases.importDocuments

Belgeleri Google Cloud Firestore'a aktarır. Aynı ada sahip mevcut dokümanların üzerine yazılır. İçe aktarma işlemi arka planda gerçekleştirilir. İçe aktarma işlemi, oluşturulan İşlem kaynağı aracılığıyla izlenip yönetilebilir. Bir Database.importDocuments işlemi iptal edilirse verilerin bir alt kümesi zaten Cloud Firestore'a aktarılmış olabilir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. İçe aktarılacak veritabanı. Şu biçimde olmalıdır: projects/{projectId}/databases/{databaseId}.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
Alanlar
collectionIds[]

string

İçe aktarılacak koleksiyon kimlikleri. Belirtilmemiş, içe aktarma işlemine dahil edilen tüm koleksiyonlar anlamına gelir.

inputUriPrefix

string

Dışa aktarılan dosyaların konumu. Bu, başarıyla tamamlanan bir dışa aktarmadaki ExportDocumentsResponse öğesinin çıkışUriPrefix ile eşleşmesi gerekir. Şu sayfaya göz atın: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.

namespaceIds[]

string

Boş liste, tüm ad alanlarını temsil eder. Bu, ad alanı kullanmayan veritabanları için tercih edilen kullanımdır.

Boş dize öğesi, varsayılan ad alanını temsil eder. Veritabanı varsayılan olmayan ad alanlarında veri içeriyorsa ancak bu verilerin dahil edilmesini istemiyorsa bu kullanılmalıdır. Bu listedeki her ad alanı benzersiz olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleye bakın.