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