Method: projects.databases.importDocuments

لاستيراد المستندات إلى Google Cloud Firestore. يتم استبدال المستندات الحالية التي تحمل الاسم نفسه. يحدث الاستيراد في الخلفية ويمكن مراقبة مستوى تقدُّمه وإدارته من خلال مورد "العملية" الذي يتم إنشاؤه. في حال إلغاء عملية datas.ImportDocuments، من المحتمل أن تكون مجموعة فرعية من البيانات قد تم استيرادها من قبل إلى Cloud Firestore.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
name

string

قاعدة بيانات للاستيراد إليها. يجب أن يكون بالتنسيق: projects/{projectId}/databases/{databaseId}.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
الحقول
collectionIds[]

string

معرّفات المجموعات المطلوب استيرادها. تعني عبارة "غير محدّدة" كل المجموعات المضمّنة في عملية الاستيراد.

inputUriPrefix

string

موقع الملفات التي تم تصديرها ويجب أن يتطابق هذا مع OutputUriPrefix لـ ExportDocumentsResponse من عملية تصدير اكتملت بنجاح. يمكنك الاطّلاع على: google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.