تتيح Google Drive API العديد من أنواع إجراءات التنزيل والتصدير، كما هو موضح في الجدول التالي:
إجراءات التنزيل |
|
||||
إجراءات التصدير |
|
قبل تنزيل محتوى الملف أو تصديره، تأكَّد من أنّه يمكن للمستخدمين تنزيل
الملف باستخدام حقل capabilities.canDownload
في موارد
files
.
للحصول على أوصاف لأنواع الملفات المذكورة هنا، بما في ذلك ملفات الكائن الثنائي الكبير وملفات Google Workspace، يُرجى الاطّلاع على أنواع الملفات.
تقدّم بقية أقسام هذا الدليل تعليمات مفصّلة لتنفيذ هذين النوعين من إجراءات التنزيل والتصدير.
تنزيل محتوى ملف رمز الجلسة
لتنزيل ملف blob مخزَّن على Drive، استخدِم الطريقة files.get
مع رقم تعريف الملف المطلوب تنزيله ومعلَمة عنوان URL alt=media
. تُعلم مَعلمة عنوان URL alt=media
الخادم بأنّه يتم طلب تنزيل المحتوى بتنسيق ردّ بديل.
مَعلمة عنوان URL alt=media
هي مَعلمة
نظام متاحة
في جميع واجهات برمجة تطبيقات Google REST. إذا كنت تستخدم مكتبة عملاء لواجهة برمجة التطبيقات
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.
يشير نموذج الرمز أيضًا إلى نوع 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
مع
معرّف الملف المطلوب تنزيله ومعرّف المراجعة. للمزيد من المعلومات،
يُرجى الاطّلاع على إدارة العمليات طويلة الأمد.