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

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