Method: files.download

تنزيل محتوى ملف تكون العمليات صالحة لمدة 24 ساعة من وقت إنشائها.

طلب HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/download

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

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

المعلمات
fileId

string

مطلوب. رقم تعريف الملف المطلوب تنزيله

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

المعلمات
mimeType

string

اختياريّ. نوع MIME الذي يجب تنزيل الملف به لا يمكن ضبط هذا الحقل إلا عند تنزيل مستندات Google Workspace. اطّلِع على أنواع MIME في files.export لمستندات Google Workspace للحصول على قائمة بأنواع MIME المتوافقة. في حال عدم ضبطه، يتم تنزيل مستند Google Workspace باستخدام نوع MIME التلقائي. قد يتغيّر نوع MIME التلقائي في المستقبل.
revisionId

string

اختياريّ. رقم تعريف النسخة من الملف المطلوب تنزيله. لا يمكن ضبط هذا الحقل إلا عند تنزيل ملفات Blob و"مستندات Google" و"جداول بيانات Google". يتم عرض القيمة INVALID_ARGUMENT إذا كان تنزيل نسخة سابقة معيّنة من الملف غير متاح.

نص الطلب

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

نص الاستجابة

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

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly

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