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

في حال استخدام الإصدار الثاني من واجهة برمجة تطبيقات Google Drive، سيكون معظم محتوى دليل واجهة برمجة تطبيقات 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 للملف. لمزيد من المعلومات، راجع تحميل بيانات الملف.

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

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

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

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

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

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