لاستيراد المستندات إلى Google Cloud Firestore. يتم استبدال المستندات الحالية التي تحمل الاسم نفسه. تحدث عملية الاستيراد في الخلفية ويمكن مراقبة مستوى تقدُّمها وإدارته من خلال مورد العملية الذي يتم إنشاؤه. في حال إلغاء عملية APIs.importDocuments، من الممكن أن يكون هناك مجموعة فرعية من البيانات قد تم استيرادها من قبل إلى Cloud Firestore.
طلب HTTP
POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
name |
مطلوبة. قاعدة بيانات ليتم الاستيراد إليها. يجب أن يكون التنسيق: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "collectionIds": [ string ], "inputUriPrefix": string, "namespaceIds": [ string ] } |
الحقول | |
---|---|
collectionIds[] |
معرّفات المجموعات المطلوب استيرادها. الحالة "غير محدّد" تعني جميع المجموعات المضمّنة في عملية الاستيراد. |
inputUriPrefix |
موقع الملفات التي تم تصديرها يجب أن يتطابق هذا الأمر مع outUriPrefix أمر ExportDocumentsResponse (الاستجابة للطلب) الذي تم إكماله بنجاح. يُرجى الاطّلاع على: |
namespaceIds[] |
تمثل القائمة الفارغة جميع مساحات الاسم. هذا هو الاستخدام المفضل لقواعد البيانات التي لا تستخدم مساحات الاسم. يمثل عنصر السلسلة الفارغ مساحة الاسم التلقائية. يجب استخدام هذا الإجراء إذا كانت قاعدة البيانات تحتوي على بيانات في مساحات اسم غير تلقائية، ولكن لا تريد تضمينها. يجب أن تكون كل مساحة اسم في هذه القائمة فريدة. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.