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

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

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

تنزيل نُسخ الملفات ونشرها

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

عرض النُسخ الفردية وتنزيلها

بعد الحصول على قائمة بنُسخ ملف، يمكنك تنزيل محتوى أي نُسخة من خلال إرسال طلب GET مُرخَّص إلى السمة []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) الخاصة بها. ينشئ Google Drive هذا الرابط القصير الأجل عند طلب النُسخة. لذا، لا تعتمد عليه لاستخدامه لاحقًا.

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