الحصول على البيانات الوصفية للملف أو محتواه برقم التعريف. التجربة الآن
في حال تقديم معلمة عنوان URL alt=media، ستتضمن الاستجابة محتوى الملف في نص الاستجابة. لا يعمل تنزيل المحتوى باستخدام alt=media إلا إذا تم تخزين الملف في Drive. لتنزيل المستندات وجداول البيانات والعروض التقديمية من Google، استخدم files.export بدلاً من ذلك. لمزيد من المعلومات عن تنزيل الملفات، يُرجى الرجوع إلى تنزيل الملفات وتصديرها.
طلب
طلب HTTP
GET https://www.googleapis.com/drive/v3/files/fileId
المعلَمات
| اسم المعلَمة | القيمة | الوصف |
|---|---|---|
| معلمات المسار | ||
fileId |
string |
معرّف الملف. |
| معلَمات طلبات البحث الاختيارية | ||
acknowledgeAbuse |
boolean |
ما إذا كان المستخدم يعترف بمخاطر تنزيل برامج ضارة معروفة أو ملفات مسيئة أخرى. ولا يسري ذلك إلا عند alt=media.
(القيمة التلقائية: false)
|
fields |
string |
مسارات الحقول التي تريد تضمينها في الاستجابة. وإذا لم يتم تحديدها، ستتضمن الاستجابة مجموعة تلقائية من الحقول الخاصة بهذه الطريقة. بالنسبة إلى التطوير، يمكنك استخدام القيمة الخاصة * لعرض جميع الحقول، ولكنك ستحقق أداءً أفضل عن طريق اختيار الحقول المطلوبة فقط. للحصول على مزيد من المعلومات، راجع إرجاع حقول معينة لأحد الملفات.
|
includeLabels |
string |
قائمة من معرّفات التصنيفات مفصولة بفواصل لتضمينها في الجزء labelInfo من الاستجابة.
|
includePermissionsForView |
string |
يحدّد أذونات العرض الإضافية المطلوب تضمينها في الاستجابة. لا يتم دعم سوى "منشورة". |
supportsAllDrives |
boolean |
ما إذا كان التطبيق مقدم الطلب يتوافق مع كل من "ملفاتي" ومساحات Drive المشتركة.
(القيمة التلقائية: false)
|
supportsTeamDrives |
boolean |
يتوافق الاستخدام المتوقّف مع AllDrives بدلاً من ذلك.
(القيمة التلقائية: false)
|
التفويض
يسمح هذا الطلب بالتفويض باستخدام نطاق واحد على الأقل من النطاقات التالية:
| النطاق |
|---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.readonly |
https://www.googleapis.com/auth/drive.metadata.readonly |
https://www.googleapis.com/auth/drive.appdata |
https://www.googleapis.com/auth/drive.metadata |
https://www.googleapis.com/auth/drive.photos.readonly |
بعض النطاقات مقيَّدة وتتطلب تقييم أمان لتطبيقك لاستخدامها. لمزيد من المعلومات، اطلع على صفحة المصادقة والتفويض.
نص الطلب
لا توفر نص طلب بهذه الطريقة.
الإجابة
وبشكل افتراضي، يستجيب هذا الإجراء باستخدام مورد ملفات في نص الاستجابة. في حال تقديم معلمة عنوان URL alt=media، ستتضمن الاستجابة محتوى الملف في نص الاستجابة. لا يعمل تنزيل المحتوى باستخدام alt=media إلا إذا تم تخزين الملف في Drive. لتنزيل المستندات وجداول البيانات والعروض التقديمية من Google، استخدم files.export بدلاً من ذلك. لمزيد من المعلومات عن تنزيل الملفات، يُرجى الرجوع إلى تنزيل الملفات وتصديرها.
جرِّب هذه الميزة الآن.
استخدم مستكشف واجهات برمجة التطبيقات أدناه لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على الاستجابة.