توفر واجهة برمجة تطبيقات Google Drive مورد المراجعات الذي يتيح لك تنزيل النُسخ السابقة من الملفات ونشرها. للحصول على مزيد من التفاصيل حول مصطلحات النسخة السابقة، يُرجى الاطّلاع على نظرة عامة على التغييرات والمراجعات.
تحديد النُسخ السابقة التي سيتم حفظها من الحذف التلقائي
يحذف Google Drive تلقائيًا النُسخ السابقة التي لم تعُد تهم المستخدم. لمنع حدوث ذلك، يمكنك ضبط العلامة المنطقية keepRevisionForever على true لوضع علامة على النُسخ السابقة التي لا تريد من Drive إزالتها نهائيًا.
تنزيل نسخة سابقة
يمكنك استخدام قيمة الحقل headRevisionId من مورد الملفات لتنزيل أحدث نسخة.
يؤدي هذا الإجراء إلى جلب النسخة السابقة التي تتوافق مع البيانات الوصفية للملف الذي تم استرداده في السابق. لتنزيل بيانات جميع النُسخ السابقة من الملف التي لا تزال مخزَّنة في السحابة الإلكترونية، يمكنك استدعاء الدالة revisions.list، والحصول على جميع أرقام التعريف المخصصة للنسخة.
لتنزيل محتوى النسخة السابقة، عليك استدعاء الطريقة
revisions.get مع المَعلمة alt=media. لا يمكن تنزيل النُسخ السابقة من "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google".
تزيد النُسخ السابقة من "مستندات Google" و"رسومات Google" و"العروض التقديمية من Google" تلقائيًا من أعداد النُسخ السابقة. ومع ذلك، قد تحتوي سلسلة الأرقام على فجوات في حالة حذف المراجعات، لذلك يجب عدم الاعتماد على الأرقام التسلسلية عند استرداد المراجعات.
نشر نسخة سابقة
لنشر نسخة سابقة من "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google"، يمكنك ضبط السمة published لهذا الملف في سمة النُسخ السابقة. لا يمكن ضبط هذا الموقع الإلكتروني لنُسخ "مواقع Google" من خلال Drive API.
إذا تم إنشاء الملف في نطاق Google Workspace ، ستشير السمة publishedOutsideDomain إلى ما إذا كان يمكن لأي شخص الوصول إلى النسخة السابقة أو ما إذا كانت تقتصر على مستخدمي النطاق. بالنسبة إلى ملفات "مواقع Google"، تشير هذه السمة إلى ما إذا كان إذن type=anyone متوفّرًا.
لا تعكس المراجعات المنشورة التغييرات التي تم إجراؤها على الملف ما لم يتم ضبط الخاصية publishAuto. إذا تم ضبط هذه الخاصية على "صحيح"، سيتم تلقائيًا نشر النُسخ الأحدث من الملف، ما يؤدي إلى استبدال النُسخ السابقة. ويتم التحكّم في هذا السلوك أيضًا من خلال مربّع الاختيار "إعادة النشر تلقائيًا عند إجراء تغييرات" في واجهة مستخدم Drive. بالنسبة إلى ملفات "مواقع Google"، تكون القيمة publishAuto دائمًا false.