Method: files.generateIds

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
count

integer

عدد أرقام التعريف المطلوب عرضها

space

string

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

type

string

تمثّل هذه السمة نوع العناصر التي يمكن استخدام المعرّفات لها. والقيمتان المسموح بإدراجهما هما "ملفات" و"اختصارات". لاحِظ أن "الاختصارات" متاحة فقط في "المساحة" 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

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