تنشئ مجموعة من معرّفات الملفات التي يمكن تقديمها في طلبات الإنشاء أو النسخ.
طلب HTTP
GET https://www.googleapis.com/drive/v3/files/generateIds
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات | |
---|---|
count |
عدد المعرّفات المطلوب عرضها. |
space |
هي المساحة التي يمكن استخدام أرقام التعريف فيها لإنشاء ملفات جديدة. القيم المسموح بها هي "drive" و"appDataمجلد". (القيمة التلقائية: 'drive') |
type |
نوع العناصر التي يمكن استخدام أرقام التعريف لها. القيم المسموح بها هي "files". و"الاختصارات". لاحظ أن "الاختصارات" لا تتوفّر إلا في "مساحة" |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بمعرّفات الملفات التي تم إنشاؤها والتي يمكن تقديمها في طلبات الإنشاء
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "ids": [ string ], "space": string, "kind": string } |
الحقول | |
---|---|
ids[] |
أرقام التعريف التي تم إنشاؤها للمستخدِم صاحب الطلب في المساحة المحدّدة |
space |
نوع الملف الذي يمكن إنشاؤه بهذه المعرّفات. |
kind |
يحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
يتم فرض قيود على بعض النطاقات وتتطلب تقييمًا أمنيًا لتطبيقك حتى يستخدمها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.