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 Transcode.

معلّمات المسار

المعلّمات
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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