Method: files.get

الحصول على البيانات الوصفية أو المحتوى الخاص بالملف باستخدام رقم التعريف

إذا قدّمت مَعلمة عنوان URL alt=media، سيتضمّن الردّ محتوى الملف في نص الاستجابة. لا يمكن تنزيل المحتوى باستخدام alt=media إلا إذا كان الملف مخزّنًا في Drive. لتنزيل "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google"، استخدِم files.export بدلاً من ذلك. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.

طلب HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}

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

مَعلمات المسار

المعلمات
fileId

string

رقم تعريف الملف

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

المعلمات
acknowledgeAbuse

boolean

ما إذا كان المستخدم يقرّ بمخاطر تنزيل برامج ضارة معروفة أو ملفات مسيئة أخرى لا ينطبق ذلك إلا عند ضبط المَعلمة alt على media وكان المستخدم مالك الملف أو منظِّم مساحة التخزين السحابي المشتركة التي يُخزَّن فيها الملف.
supportsAllDrives

boolean

ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام supportsAllDrives بدلاً منها.
includePermissionsForView

string

تُستخدَم لتحديد أذونات العرض الإضافية المطلوب تضمينها في الاستجابة. لا يُسمح إلا بالقيمة "منشور".
includeLabels

string

قائمة مفصولة بفواصل بأرقام تعريف التصنيفات المطلوب تضمينها في الجزء labelInfo من الاستجابة

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال File.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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