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

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

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

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

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

عرض المراجعات الفردية وتنزيلها

بعد الحصول على قائمة بمراجعات ملف، يمكنك تنزيل محتوى أي مراجعة من خلال إرسال طلب GET معتمد إلى السمة []downloadUrl](/workspace/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". أدرِج مَعلمات طلب البحث files.insert convert واضبط السمة (workspace_name) mimeType للملف. لمزيد من المعلومات، يُرجى الاطّلاع على تحميل بيانات الملفات.

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

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

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

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

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

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