Method: files.generateIds

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

طلب HTTP

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

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

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

المَعلمات
count

integer

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

space

string

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

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