دليل الإصدار الثاني من 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 على عدة مَعلمات خاصة بالمساحات المشتركة. للاطّلاع على قائمة المَعلمات، يُرجى الانتقال إلى قسم تتبُّع التغييرات في مساحة Drive مشتركة.

تحميل ملفات

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