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 المتوافقة، يُرجى الانتقال إلى أنواع MIME لتصدير مستندات 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

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