تتيح واجهة برمجة التطبيقات Google Drive API عدة أنواع من إجراءات التنزيل والتصدير، كما هو موضّح في الجدول التالي:
عمليات التنزيل |
|
|||
عمليات التصدير |
|
يوفر الجزء المتبقي من هذا الدليل إرشادات مفصلة لتنفيذ هذه الأنواع من إجراءات التنزيل والتصدير.
تنزيل محتوى ملف blob
لتنزيل ملف ثنائي كبير مخزَّن على Drive، استخدِم الطريقة files.get
مع رقم تعريف الملف المطلوب تنزيله
ومَعلمة عنوان URL للسمة alt=media
. توضِّح معلَمة عنوان URL alt=media
للخادم أنّه يتم طلب تنزيل المحتوى كتنسيق استجابة بديل.
معلَمة عنوان URL alt=media
هي مَعلمة نظام
متوفّرة في جميع واجهات برمجة تطبيقات Google REST. إذا كنت تستخدم مكتبة برامج لواجهة برمجة تطبيقات Drive،
لن تحتاج إلى ضبط هذه المعلمة بشكل صريح.
يوضّح نموذج الرمز التالي كيفية استخدام الطريقة files.get
لتنزيل ملف باستخدام مكتبات برامج واجهة برمجة التطبيقات Drive API.
لغة Java
لغة Python
Node.js
2,999
NET.
يستخدم نموذج الرمز هذا طريقة مكتبة تضيف معلَمة عنوان URL alt=media
إلى طلب HTTP الأساسي.
يجب أن يتم السماح بتنزيل الملفات التي بدأت من تطبيقك بنطاق يسمح
بالوصول للقراءة إلى محتوى الملف. على سبيل المثال، التطبيق الذي يستخدم
نطاق drive.readonly.metadata
غير مسموح له بتنزيل محتوى الملف.
يستخدم نموذج الرمز هذا نطاق ملف "Drive" المشروط الذي يسمح للمستخدمين بعرض جميع ملفات Drive وإدارتها. لمعرفة المزيد من المعلومات عن نطاقات Drive، يمكنك الرجوع إلى معلومات المصادقة والترخيص المتعلقة بواجهة برمجة التطبيقات.
يمكن للمستخدمين الذين لديهم أذونات للتعديل حظر التنزيل من قِبل مستخدمين لديهم الإذن بالقراءة فقط، وذلك من خلال ضبط الحقل
copyRequiresWriterPermission
على false
.
الملفات التي يتم تحديدها على أنّها
مسيئة
(مثل البرامج الضارة) لا يمكن تنزيلها إلا من قِبل مالك الملف.
بالإضافة إلى ذلك، يجب تضمين معلَمة طلب البحث get
acknowledgeAbuse=true
للإشارة إلى أنّ المستخدم قد أقرّ بخطر تنزيل برامج غير مرغوب فيها أو ملفات أخرى مسيئة. يجب أن يحذر تطبيقك بشكل تفاعلي
المستخدم قبل استخدام معلمة طلب البحث هذه.
تنزيل جزئي
تتضمن التنزيل الجزئي تنزيل جزء محدد فقط من الملف. يمكنك تحديد جزء الملف الذي تريد تنزيله باستخدام نطاق بايت
مع العنوان Range
. مثلاً:
Range: bytes=500-999
تنزيل محتوى ملف ثنائي كبير (blob) في إصدار سابق
لتنزيل محتوى ملفات blob في إصدار سابق، استخدِم الطريقة
revisions.get
مع رقم تعريف
الملف الذي تريد تنزيله ورقم تعريف النسخة السابقة ومَعلمة عنوان URL للسمة alt=media
.
تخبر معلَمة عنوان URL alt=media
الخادم بأنّه يتم طلب تنزيل المحتوى كتنسيق استجابة بديل. على غرار files.get
، تقبل الطريقة revisions.get
أيضًا مَعلمة طلب البحث الاختيارية acknowledgeAbuse
وعنوان Range
. للحصول على مزيد من المعلومات حول تنزيل النُسخ السابقة، يمكنك الاطّلاع على تنزيل النُسخ السابقة من الملفات ونشرها.
تنزيل محتوى ملف ثنائي كبير (blob) في المتصفِّح
لتنزيل محتوى ملفات blob التي تم تخزينها على Drive في متصفح، بدلاً من
استخدام واجهة برمجة التطبيقات، استخدم الحقل
webContentLink
لمورد Files
. إذا كان لدى المستخدم حق الوصول للتنزيل
إلى الملف، يتم عرض رابط لتنزيل الملف ومحتواه. يمكنك إما إعادة توجيه المستخدم إلى عنوان URL هذا أو عرضه كرابط قابل للنقر.
تصدير محتوى مستند Google Workspace
لتصدير محتوى بايت في مستند Google Workspace، استخدِم طريقة files.export
مع معرّف الملف المطلوب تصديره
ونوع MIME الصحيح. يقتصر حجم المحتوى المصدَّر
على 10 ميغابايت.
يوضّح نموذج الرمز التالي كيفية استخدام طريقة files.export
لتصدير
مستند Google Workspace بتنسيق PDF باستخدام مكتبات برامج Drive API:
لغة Java
لغة Python
Node.js
2,999
NET.
يستخدم نموذج الرمز هذا نطاق drive
المشروط الذي يسمح للمستخدمين بعرض جميع ملفات Drive وإدارتها. لمعرفة المزيد من المعلومات عن نطاقات 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 هذا أو عرضه كرابط قابل للنقر.