دليل الإصدار الثاني من Drive API

إذا كنت تستخدم الإصدار 2 من Google Drive API، يرتبط معظم المحتوى في الإصدار 3 من دليل واجهة برمجة تطبيقات Google Drive بالإصدار 2 أيضًا. يتضمّن هذا القسم كل المعلومات الخاصة بالإصدار 2 والمختلفة عن المعلومات المعروضة في الصفحات المحددة من دليل الإصدار 3. للحصول على السياق الكامل، يحتوي كل قسم فرعي على رابط إلى صفحة الدليل المقابلة.

للحصول على قائمة كاملة بالاختلافات، يُرجى الاطّلاع على مرجع المقارنة بين الإصدارَين 2 و3 من Drive API.

تنزيل النُسخ السابقة من الملفات ونشرها

في صفحة تنزيل النُسخ السابقة من الملف ونشرها، تقتصر المعلومات التالية على الإصدار 2، وتحل محل الأقسام التالية المعروضة في الإصدار 3:

سرد النُسخ السابقة وتنزيلها

بعد الحصول على قائمة بالنسخ السابقة من الملف، يمكنك تنزيل محتوى أي نسخة سابقة من خلال إرسال طلب GET معتمَد إلى السمة []downloadUrl](/drive/api/reference/rest/v2/revisions). ينشئ Google Drive عنوان URL قصير الأجل هذا عند طلب النسخة السابقة. ولا تعتمد عليه للاستخدام لاحقًا.

ويمكنك أيضًا تصدير النسخة السابقة بأحد التنسيقات المتوافقة عن طريق التحقّق من السمة exportLinks.

خصائص الملف المخصّصة

بالإضافة إلى المعلومات الواردة في صفحة إضافة خصائص ملف مخصصة، تنطبق المعلومات التالية على الإصدار 2:

ويمكن الوصول إلى المواقع باستخدام المورد properties.

وهذه هي بنية سمة نموذجية يمكن استخدامها لتخزين رقم تعريف قاعدة بيانات ملف Drive على الملف.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

لمزيد من المعلومات حول الحدود القصوى، يُرجى الاطّلاع على القسم properties في المستندات المرجعية.

تفعيل دعم مساحة التخزين السحابي المشتركة

بالإضافة إلى المعلومات الواردة في صفحة تنفيذ دعم مساحة التخزين السحابي المشتركة، يمكنك استبدال هذا الحقل الإضافي trashedDate للإصدار 2.

في تنفيذ دعم مساحات التخزين السحابي المشتركة، تتطلب الطرق التالية supportsAllDrives=true عند التعامل مع محتوى مساحات التخزين السحابي المشتركة:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

تحتوي الطريقتان changes.get وchanges.list على عدّة معلَمات خاصة بمساحات التخزين السحابي المشتركة. للحصول على قائمة بالمَعلمات، اطّلِع على قسم تتبُّع التغييرات في مساحة تخزين سحابي مشتركة.

تحميل الملفات

في صفحة تحميل بيانات الملف، لاحظ أن هذه المعلومات خاصة بالإصدار 2:

الاستيراد إلى أنواع "مستندات Google"

عند إنشاء ملف في Google Drive، يمكنك تحويل بعض أنواع الملفات إلى مستند في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google". ضمِّن مَعلمات طلب البحث convert files.insert واضبط سمة (workspace_name) mimeType للملف. لمزيد من المعلومات، يُرجى الاطّلاع على تحميل بيانات الملفات.

مشاركة الملفات والمجلدات ومساحات التخزين السحابي

يحدد الإشعار في صفحة مشاركة الملفات والمجلدات ومساحات التخزين السحابي، في الإصدار 3 من حقل واحد فقط، role الأدوار الفعالة للمستخدم أو المجموعة أو النطاق. في الإصدار 2، يجب أن يعكس حقلا الإذن role وadditionalRoles الأدوار الفعّالة التي يمتلكها المستخدم أو المجموعة أو النطاق لعنصر معيّن.

الاختلافات في طلبات البحث للإصدار 2

حقل الإصدار 2 title هو name في الإصدار 3. للحصول على أمثلة، راجع البحث عن الملفات والمجلدات.

حقل الإصدار 2 createdDate هو createdTime في الإصدار 3. للحصول على أمثلة، راجع البحث عن مساحات التخزين السحابي المشتركة.

حقل الإصدار 2 modifiedDate هو modifiedTime في الإصدار 3. حقل الإصدار 2 lastViewedByMeDate هو viewedByMeTime في الإصدار 3. لمزيد من التفاصيل، يُرجى الاطّلاع على عبارات طلب البحث وعوامل التشغيل.