تتيح Google Drive API العديد من أنواع إجراءات التنزيل والتصدير، كما هو موضح في الجدول التالي:
إجراءات التنزيل |
|
||||
تصدير الإجراءات |
|
قبل تنزيل محتوى الملف أو تصديره، تأكَّد من أنّه يمكن للمستخدمين تنزيل
الملف باستخدام حقل capabilities.canDownload
في موارد
files
.
للحصول على أوصاف لأنواع الملفات المذكورة هنا، بما في ذلك ملفات blob وملفّات Google Workspace، يُرجى الاطّلاع على أنواع الملفات.
تقدّم بقية أقسام هذا الدليل تعليمات مفصّلة لتنفيذ هذين النوعين من إجراءات التنزيل والتصدير.
تنزيل محتوى ملف رمز الجلسة
لتنزيل ملف ملفّات بترميز ثنائي مخزّن على Drive، استخدِم الطريقة files.get
مع رقم تعريف الملف المطلوب تنزيله
ومَعلمة عنوان URL alt=media
. تُعلم مَعلمة عنوان URL alt=media
الخادم بأنّه يتم طلب تنزيل المحتوى بتنسيق ردّ بديل.
معلمة عنوان URL alt=media
هي مَعلمة
نظام متاحة
في جميع واجهات برمجة تطبيقات Google REST API. إذا كنت تستخدم مكتبة عملاء لواجهة برمجة التطبيقات
Drive API، لن تحتاج إلى ضبط هذه المَعلمة صراحةً.
يوضّح نموذج الرمز البرمجي التالي كيفية استخدام الطريقة files.get
لتنزيلملف باستخدام مكتبات عملاء Drive API.
Java
Python
Node.js
PHP
NET.
يستخدم نموذج الرمز البرمجي هذا طريقة مكتبة تضيف مَعلمة عنوان URLalt=media
إلى طلب HTTP الأساسي.
يجب أن تكون عمليات تنزيل الملفات التي تبدأ من تطبيقك مفوَّضة بنطاق يسمح
بالوصول للقراءة إلى محتوى الملف. على سبيل المثال، لا يُسمح لتطبيق يستخدم النطاق
drive.readonly.metadata
بتنزيل محتوى الملف.
يستخدم نموذج الرمز البرمجي هذا نطاق ملف "drive" المحدود الذي يسمح للمستخدمين باطلاعهم على كل ملفاتك في Drive وإدارتها. للاطّلاع على مزيد من المعلومات حول
نطاقات Drive، يُرجى الرجوع إلى مقالة اختيار نطاقات Google Drive API.
يمكن للمستخدمين الذين لديهم أذونات تعديل حظر تنزيل الملفات من قِبل المستخدمين الذين لديهم إذن بالقراءة فقط من خلال
ضبط الحقل copyRequiresWriterPermission
على false
.
لا يمكن لأحد غير مالك الملف تنزيل الملفات التي تم تصنيفها على أنّها مسيئة
(مثل البرامج الضارة).
بالإضافة إلى ذلك، يجب تضمين مَعلمة الطلب get
acknowledgeAbuse=true
لبيان أنّ المستخدم قد أقرّ بمخاطر تنزيل برامج قد تكون
غير مرغوب فيها أو ملفات مسيئة أخرى. يجب أن يُحذّر تطبيقك المستخدم بشكل تفاعلي قبل استخدام مَعلمة طلب البحث هذه.
تنزيل جزئي
يتضمن التنزيل الجزئي تنزيل جزء محدّد من الملف فقط. يمكنك تحديد الجزء من الملف الذي تريد تنزيله باستخدام نطاق ملف برمجي مع العنوان
Range
. على سبيل المثال:
Range: bytes=500-999
تنزيل محتوى ملف رمز بيانات غير منتظم في إصدار سابق
لتنزيل محتوى ملفات Blob في إصدار سابق، استخدِم الأسلوب
revisions.get
مع معرّف
الملف المطلوب تنزيله ومعرّف النسخة ومعلمة عنوان URL alt=media
.
تُعلم مَعلمة عنوان URL alt=media
الخادم بأنّه يتم طلب تنزيل المحتوى
كتنسيق بديل للردّ. على غرار files.get
، تقبل الطريقة
revisions.get
أيضًا مَعلمة طلب البحث الاختيارية
acknowledgeAbuse
وعنوان Range
. لمزيد من المعلومات حول تنزيل
النُسخ السابقة، يُرجى الاطّلاع على إدارة نُسخ الملفات السابقة.
يظهر هنا بروتوكول الطلب.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID
}/revisions/{REVISION_ID
}?alt=media
تنزيل محتوى ملف رمز بيانات في متصفّح
لتنزيل محتوى ملفات Blob المخزّنة على Drive في
متصفّح، بدلاً من استخدام واجهة برمجة التطبيقات، استخدِم الحقل
webContentLink
لمرجع
files
. إذا كان لدى المستخدم إذن بالوصول إلى الملف للتنزيل، يتم عرض رابط لتنزيل الملف ومحتوياته. يمكنك إعادة توجيه المستخدم إلى عنوان URL هذا أو عرضه كأحد
الروابط القابلة للنقر.
تنزيل محتوى ملف العنصر أثناء العمليات التي تستغرق وقتًا طويلاً
لتنزيل محتوى ملفات Blob أثناء العمليات التي تستغرق وقتًا طويلاً، استخدِم الأسلوب
files.download
مع رقم تعريف
الملف المطلوب تنزيله. يمكنك اختياريًا ضبط معرّف النسخة. هذه هي
الطريقة الوحيدة لتنزيل ملفات Google Vids. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة
العمليات التي تستغرق وقتًا طويلاً.
تصدير محتوى مستندات Google Workspace
لتصدير محتوى وحدات البايت في مستند Google Workspace، استخدِم طريقة files.export
مع معرّف الملف المطلوب تصديره
ونوع MIME الصحيح. يقتصر حجم المحتوى الذي تم تصديره على 10 ميغابايت.
يوضّح نموذج الرمز البرمجي التالي كيفية استخدام الطريقة files.export
لتصدير
مستند Google Workspace بتنسيق PDF باستخدام مكتبات العميل
Drive API:
Java
Python
Node.js
PHP
NET.
يستخدم نموذج الرمز البرمجي هذا النطاق المحدود drive
الذي يسمح للمستخدمين بعرض
وإدارة جميع ملفاتك على Drive. للاطّلاع على مزيد من المعلومات حول
نطاقات Drive، يُرجى الرجوع إلى مقالة اختيار نطاقات Google Drive API.
يُعلن نموذج الرمز البرمجي أيضًا عن نوع MIME للتصدير على أنّه application/pdf
. للحصول على
قائمة كاملة بجميع أنواع MIME المتوافقة للتصدير لكل مستند
في Google Workspace، يُرجى الاطّلاع على تصدير أنواع MIME لمستندات
Google Workspace.
تصدير محتوى مستند Google Workspace في متصفّح
لتصدير محتوى مستند Google Workspace في متصفّح، استخدِم الحقل
exportLinks
لمصدر
files
. استنادًا إلى نوع
المستند، يتم عرض رابط لتنزيل الملف ومحتواه لكل نوع
MIME متاح. يمكنك إعادة توجيه المستخدم إلى عنوان URL أو تقديمه كأحد
الروابط القابلة للنقر.
تصدير محتوى مستند Google Workspace بإصدار سابق في متصفّح
لتصدير محتوى مستند Google Workspace في إصدار سابق ضمن
متصفّح، استخدِم طريقة revisions.get
مع رقم تعريف الملف المطلوب تنزيله ورقم تعريف النسخة المعدَّلة لإنشاء
رابط تصدير يمكنك من خلاله إجراء عملية التنزيل. إذا كان لدى المستخدم إذن بالوصول إلى الملف للتنزيل، يتم عرض رابط لتنزيل الملف ومحتوياته. يمكنك إعادة توجيه المستخدم إلى عنوان URL هذا أو عرضه كأحد
الروابط القابلة للنقر.
تصدير محتوى مستندات Google Workspace أثناء العمليات التي تستغرق وقتًا طويلاً
لتصدير محتوى مستند Google Workspace أثناء العمليات التي تستغرق وقتًا طويلاً،
استخدِم طريقة files.download
مع
معرّف الملف المطلوب تنزيله ومعرّف المراجعة. لمزيد من المعلومات،
يُرجى الاطّلاع على إدارة العمليات التي تستغرق وقتًا طويلاً.