توفّر Google Drive API مورد revisions
ليتسنى لك تنزيل نُسخ الملفات ونشرها. لمزيد من التفاصيل حول مصطلحات المراجعة، اطّلِع على نظرة عامة حول التغييرات والمراجعات.
يوضّح هذا الدليل كيفية إدارة نُسخ الملفات باستخدام Google Drive API.
تحديد المراجعات التي تريد حفظها من الحذف التلقائي
يحذف Google Drive تلقائيًا المراجعات القديمة التي لم يعُد المستخدم مهتمًا بها.
يمكن ضبط نسخة ملف blob على "الاحتفاظ إلى الأبد"، ما يعني أنّه لا يمكن إزالة النسخة تلقائيًا. يمكن ضبط ما يصل إلى 200 نسخة سابقة على "الاحتفاظ إلى الأبد"، وسيتم احتسابها ضمن الحد الأقصى لمساحة التخزين. لا يتم مطلقًا إزالة المراجعة الرئيسية تلقائيًا.
يمكن حذف أي نسخة سابقة من ملف كائن ثنائي كبير الحجم (blob)، باستثناء النسخة الرئيسية، إذا لم يتم تصنيفها على أنّها "الاحتفاظ بها للأبد". يتم عادةً الاحتفاظ بالنسخ القابلة للحذف لمدة 30 يومًا، ولكن يمكن حذفها قبل ذلك إذا كان الملف يتضمّن 100 نسخة غير مصنّفة على أنّها "يجب الاحتفاظ بها إلى الأبد" وتم تحميل نسخة جديدة.
يمكنك ضبط الحقل المنطقي keepForever الخاص بمورد revisions على true لوضع علامة على المراجعات التي لا تريد أن يمحوها Drive. بعد ضبط مراجعة ملف كائن ثنائي كبير (BLOB) على "الاحتفاظ إلى الأبد"، يمكن تنزيلها أو حذفها فقط. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل نسخة معدَّلة أو حذف نسخة معدَّلة.
تنزيل نسخة سابقة
يمكنك فقط تنزيل تنقيحات ملفات الكائنات الثنائية الكبيرة التي تم وضع علامة "الاحتفاظ بها للأبد" عليها. إذا أردت تنزيل نسخة معدَّلة، احرص على ضبطها على "الاحتفاظ بها للأبد" أولاً. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد المراجعات التي يجب حفظها من الحذف التلقائي.
لتنزيل مراجعة لمحتوى ملف كبير الحجم أو لتصدير مراجعة لمحتوى مستند Google Workspace، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.
حذف نسخة سابقة
يمكنك استدعاء طريقة revisions.delete
لحذف مراجعة ملف كائن ثنائي كبير نهائيًا، حتى عندما يتم وضع علامة
"الاحتفاظ بها للأبد" عليها.
إذا كنت تستخدم الإصدار القديم من Drive API (v2)، استخدِم الحقل pinned الخاص بمورد revisions بدلاً من ذلك.
نشر نسخة سابقة
لنشر مراجعة في "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google"، اضبط السمة published لهذا الملف في مورد revisions. لا يمكن ضبط هذه السمة لنُسخ مواقع Google باستخدام Drive API.
لا تتيح "العروض التقديمية من Google" و"رسومات Google" نشر مراجعات معيّنة. لا يتوفّر سوى إعادة نشر تلقائي لأحدث نسخة معدَّلة. لنشر "العروض التقديمية من Google" و"رسومات Google"، يجب أيضًا ضبط publishAuto على true.
إذا تم إنشاء الملف في نطاق Google Workspace، تشير السمة publishedOutsideDomain إلى ما إذا كان بإمكان أي مستخدم الوصول إلى المراجعة أو ما إذا كان الوصول مقتصرًا على مستخدمي النطاق. بالنسبة إلى ملفات Sites
، يشير هذا الموقع إلى ما إذا كان هناك إذن type=anyone. لمزيد من المعلومات، يُرجى الاطّلاع على الحقل type في المرجع permissions.
لا تعكس المراجعات المنشورة التغييرات التي تم إجراؤها على ملف ما لم يتم ضبط السمة
publishAuto. إذا تم ضبط الموقع على true، سيتم تلقائيًا نشر أحدث المراجعات لملف، ما يؤدي إلى استبدال المراجعات السابقة.
تتيح "العروض التقديمية من Google" و"رسومات Google" إعادة النشر التلقائي فقط، ويجب ضبط السمة publishAuto على true. بالنسبة إلى ملفات "مواقع Google"، تكون قيمة publishAuto هي false دائمًا.
يتم أيضًا التحكّم في النشر التلقائي من خلال مربّع الاختيار "إعادة النشر تلقائيًا عند إجراء تغييرات" في واجهة المستخدم لكل من "مستندات Google" و"جداول بيانات Google". لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"نماذج Google" لجميع المستخدمين.