Method: files.get

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

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

طلب HTTP

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

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

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

المَعلمات
fileId

string

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

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

المَعلمات
acknowledgeAbuse

boolean

ما إذا كان المستخدم يقرّ بمخاطر تنزيل برامج ضارة معروفة أو ملفات مسيئة أخرى

projection
(deprecated)

enum (Projection)

مهملة: لا تتضمن هذه المعلمة أي وظيفة.

revisionId

string

تُحدِّد رقم تعريف النسخة السابقة التي يجب تنزيلها. يتم تجاهله ما لم يتم تحديد alt=media.

supportsAllDrives

boolean

ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.

updateViewedDate
(deprecated)

boolean

متوقّف نهائيًا: استخدِم files.update مع modifiedDateBehavior=noChange, updateViewedDate=true ونص طلب فارغ.

includePermissionsForView

string

تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يُسمح فقط بالقيمة published.

includeLabels

string

قائمة مفصولة بفواصل تضم معرّفات التصنيفات المراد تضمينها في الجزء labelInfo من الإجابة.

نص الطلب

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

نص الاستجابة

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

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

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

  • https://www.googleapis.com/auth/docs
  • 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

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