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şir ve ilerleme durumu, oluşturulan işlem kaynağıyla izlenip yönetilebilir. 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ı. projects/{projectId}/databases/{databaseId} biçiminde olmalıdır.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

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

string

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

inputUriPrefix

string

Dışa aktarılan dosyaların konumu. Bu değişken, başarıyla tamamlanan bir dışa aktarma işlemindeki ExportDocumentsResponse'taki exitUriPrefix ile eşleşmelidir. Şu sayfaya göz atın: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.

namespaceIds[]

string

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

Boş bir dize öğesi, varsayılan ad alanını temsil eder. Veritabanının varsayılan olmayan ad alanlarında verileri varsa ancak bunları dahil etmek istemiyorsa bu seçenek kullanılmalıdır. Bu listedeki her ad alanı benzersiz olmalıdır.

Yanıt gövdesi

Başarılıysa yanıt metni, 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ış sayfasına göz atın.