Method: files.generateIds

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

طلب HTTP

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

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

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

المعلمات
count

integer

عدد المعرّفات المطلوب عرضها.

space

string

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

type

string

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

نص الطلب

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

نص الاستجابة

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

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

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

string

أرقام التعريف التي تم إنشاؤها للمستخدِم صاحب الطلب في المساحة المحدّدة

space

string

نوع الملف الذي يمكن إنشاؤه بهذه المعرّفات.

kind

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#generatedIds"

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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