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

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