Method: files.generateIds

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

طلب HTTP

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

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

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

المعلمات
count

integer

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

string

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

string

نوع العناصر التي يمكن استخدام الأرقام التعريفية لها القيم المسموح بها هي "الملفات" و"الاختصارات". يُرجى العلم أنّ "الاختصارات" لا تتوفّر إلا في "المسافة" drive. (الإعداد التلقائي: "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

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