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

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

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

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