دليل الإصدار الثاني من 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. لمزيد من التفاصيل، يُرجى الاطّلاع على عبارات البحث وعوامل التشغيل.