Method: files.generateIds

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

طلب HTTP

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

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

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

المعلمات
count

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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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