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