توفر واجهة برمجة تطبيقات 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
ملفات "مواقع Google"، تشير هذه السمة إلى ما إذا كان يتوفّر إذن "type=anyone".
لا تعكس النُسخ السابقة المنشورة التغييرات التي تم إجراؤها على ملف ما لم يتم ضبط السمة publishAuto. إذا تم تعيين هذه الخاصية على True، فسيتم نشر النُسخ الأحدث من الملف تلقائيًا، وستحل هذه النُسخ محل النُسخ السابقة. يتم أيضًا التحكّم في هذا السلوك من خلال ميزة "إعادة النشر تلقائيًا عند إجراء تغييرات". مربع الاختيار في واجهة مستخدم Drive. بالنسبة إلى ملفات "مواقع Google"، تكون قيمة publishAuto دائمًا false.