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

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