تتيح واجهة برمجة التطبيقات Google Drive API عدة أنواع من إجراءات التنزيل والتصدير، مثل مدرجة في الجدول التالي:
عمليات التنزيل |
|
|||
الصادرات |
|
قبل تنزيل محتوى الملف أو تصديره، تأكَّد من إمكانية تنزيل المستخدمين
باستخدام الحقل capabilities.canDownload
في
files
المرجع.
ويقدم باقي هذا الدليل تعليمات مفصلة عن تنفيذ هذه الأنواع من إجراءات التنزيل والتصدير.
تنزيل محتوى ملف الكائن الثنائي الكبير (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.
يستخدم نموذج الرمز هذا طريقة مكتبة تضيف معلَمة عنوان URL alt=media
.
إلى طلب HTTP الأساسي.
يجب السماح بعمليات تنزيل الملفات التي تم بدؤها من تطبيقك من خلال نطاق يسمح
إذن قراءة محتوى الملف. على سبيل المثال، أحد التطبيقات التي تستخدم
غير مسموح لنطاق drive.readonly.metadata
بتنزيل محتوى الملف.
يستخدم نموذج الرمز البرمجي هذا نطاق ملف "drive" المقيّد الذي يسمح للمستخدمين
عرض جميع ملفات Drive وإدارتها لمزيد من المعلومات حول
نطاقات Drive، يُرجى الاطّلاع على مقالة اختيار Google Drive API.
والنطاقات.
يمكن للمستخدمين الذين لديهم أذونات تعديل منع التنزيل من قِبل مستخدمي القراءة فقط من خلال
ضبط 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
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 هذا، أو عرضه كعنوان قابل للنقر.
.