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

إذا كنت تستخدم الإصدار 2 من Google Drive API، ينطبق معظم المحتوى في الإصدار 3 من دليل Google Drive API على الإصدار 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". أدرِج مَعلمات طلب البحث files.insert convert واضبط السمة (workspace_name) mimeType للملف. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل بيانات الملفات.

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

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

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

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

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

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