Method: files.generateIds

تُنشئ هذه الوظيفة مجموعة من أرقام تعريف الملفات التي يمكن تقديمها في طلبات الإدراج أو النسخ.

طلب HTTP

GET https://www.googleapis.com/drive/v2/files/generateIds

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

مَعلمات طلب البحث

المعلمات
maxResults

integer

الحد الأقصى لعدد المعرّفات التي سيتم عرضها
space

string

المساحة التي يمكن فيها استخدام المعرّفات لإنشاء ملفات جديدة. القيم المسموح بها هي drive وappDataFolder. (القيمة التلقائية: drive)
type

string

نوع العناصر التي يمكن استخدام الأرقام التعريفية لها القيم المسموح بها هي files وshortcuts. يُرجى العلم أنّ shortcuts لا تتوفّر إلا في drive space. (القيمة التلقائية: files)

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بالمعرّفات التي تم إنشاؤها والتي يمكن تقديمها في طلبات الإدراج

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "ids": [
    string
  ],
  "space": string,
  "kind": string
}
الحقول
ids[]

string

المعرّفات التي تم إنشاؤها للمستخدم الذي يطلب الإجراء في المساحة المحدّدة
space

string

نوع الملف الذي يمكن إنشاؤه باستخدام هذه المعرّفات
kind

string

هذا الإعداد دائمًا هو drive#generatedIds

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

تكون بعض النطاقات محظورة وتتطلّب تقييم أمان ليتمكّن تطبيقك من استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.