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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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