إدارة النُسخ السابقة من الملفات

يوضّح هذا الدليل كيفية استخدام مورد revisions لإدارة النسخ السابقة من الملفات، مثل الحصول على نسخة سابقة من ملف ونشر نسخة سابقة من ملف في Google Workspace. تتيح لك Google Drive API أيضًا تنزيل النُسخ المعدَّلة. لمزيد من التفاصيل حول مصطلحات المراجعة، اطّلِع على نظرة عامة على التغييرات والمراجعات.

للوصول إلى سجلّ النُسخ السابقة، يجب أن يكون لدى المستخدم إذن role من owner أو organizer أو fileOrganizer أو writer.

لتحديد الحقول التي سيتم عرضها في الاستجابة، يمكنك ضبط fields مَعلمة النظام باستخدام أي طريقة من طرق المورد revisions. في حال عدم تضمين المَعلمة، يعرض الخادم مجموعة حقول تلقائية. على سبيل المثال، لا تعرض الطريقة revisions.list سوى الحقول id وmimeType وkind وmodifiedTime. لعرض حقول مختلفة، راجِع عرض حقول محدّدة.

تحديد المراجعات التي تريد حفظها من الحذف التلقائي

يحذف Google Drive تلقائيًا المراجعات القديمة التي لم يعُد المستخدم مهتمًا بها.

يمكن ضبط نسخة ملف blob على "الاحتفاظ إلى الأبد"، ما يعني أنّه لا يمكن إزالة النسخة تلقائيًا. يمكن ضبط ما يصل إلى 200 نسخة سابقة على "الاحتفاظ إلى الأبد"، وسيتم احتسابها ضمن الحد الأقصى لمساحة التخزين. لا يتم مطلقًا إزالة المراجعة الرئيسية تلقائيًا.

يمكن حذف أي نسخة سابقة من ملف كائن ثنائي كبير الحجم (blob)، باستثناء النسخة الرئيسية، إذا لم يتم تصنيفها على أنّها "الاحتفاظ بها للأبد". يتم عادةً الاحتفاظ بالنسخ القابلة للحذف لمدة 30 يومًا، ولكن يمكن حذفها قبل ذلك إذا كان الملف يتضمّن 100 نسخة غير مصنّفة على أنّها "يجب الاحتفاظ بها إلى الأبد" وتم تحميل نسخة جديدة.

يمكنك ضبط الحقل المنطقي keepForever الخاص بمورد revisions على true لوضع علامة على المراجعات التي لا تريد أن يمحوها Drive. بعد ضبط مراجعة ملف كائن ثنائي كبير (BLOB) على "الاحتفاظ إلى الأبد"، يمكن تنزيلها أو حذفها فقط. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل نسخة معدَّلة أو حذف نسخة معدَّلة.

إذا كنت تستخدم الإصدار القديم من Drive API‏ (v2)، استخدِم الحقل pinned الخاص بالمرجع revisions بدلاً من keepForever.

الحصول على نسخة سابقة من ملف

للحصول على البيانات الوصفية أو المحتوى الخاصين بمراجعة ملف، استخدِم طريقة get في مورد revisions مع مَعلمتَي المسار fileId وrevisionId. إذا كنت لا تعرف معرّف المراجعة، يمكنك إدراج جميع المراجعات في ملف باستخدام طريقة list.

تعرض الطريقة البيانات الوصفية للمراجعة كنموذج من revisions المورد.

لإقرارك بمخاطر تنزيل برامج ضارة معروفة أو ملفات مسيئة أخرى، اضبط مَعلمة طلب البحث acknowledgeAbuse على true. لا ينطبق هذا الحقل إلا عندما يتم ضبط المَعلمة alt=media ويكون المستخدم إما مالك الملف أو منظّم مساحة التخزين السحابي المشتركة التي يتضمّنها الملف.

عرض قائمة بنسخ ملف سابقة

لعرض قائمة بنُسخ ملف سابقة، استخدِم طريقة list على مصدر revisions مع مَعلمة المسار fileId. تُرجع الطريقة قائمة بنُسخ الملفات السابقة.

مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات أو فلترة المراجعات:

  • pageSize: الحد الأقصى لعدد المراجعات التي سيتم عرضها في كل صفحة

  • pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.

تعديل نسخة من ملف

لتعديل نسخة من ملف، استخدِم الطريقة update في المورد revisions مع مَعلمتَي المسار fileId وrevisionId.

تُرجع الطريقة مثيلاً لمورد revisions.

تنزيل نسخة معدَّلة

يمكنك فقط تنزيل تنقيحات محتوى ملفات blob التي تم وضع علامة "الاحتفاظ بها للأبد" عليها. إذا أردت تنزيل نسخة معدَّلة، احرص على ضبطها على "الاحتفاظ بها للأبد" أولاً. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد المراجعات التي يجب حفظها من الحذف التلقائي.

لتنزيل مراجعة لمحتوى ملف كبير الحجم أو لتصدير مراجعة لمحتوى مستند Google Workspace، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.

حذف نسخة سابقة من ملف

لحذف مراجعة ملف نهائيًا، استخدِم طريقة delete في مورد revisions مع مَعلمتَي المسار fileId وrevisionId.

يمكنك حذف نُسخ ملفات البيانات الثنائية التي تتضمّن محتوًى ثنائيًا في Drive فقط، مثل الصور والفيديوهات وملفات PDF. يمكنك حذف مراجعة لملف كائن ثنائي كبير الحجم (blob) عندما يتم وضع علامة "الاحتفاظ بها للأبد" عليها. لا يمكن حذف النُسخ السابقة من الملفات الأخرى، مثل مستند Google أو جدول بيانات Google، وآخر نسخة سابقة متبقية من الملف الثنائي.

نشر نسخة معدَّلة

لنشر مراجعة في "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google"، اضبط السمة published لهذا الملف في مورد revisions. لا يمكن ضبط هذه السمة لنُسخ مواقع Google باستخدام Drive API.

لا تعكس المراجعات المنشورة التغييرات التي تم إجراؤها على ملف ما لم يتم ضبط السمة publishAuto. إذا تم ضبط الموقع على true، سيتم تلقائيًا نشر أحدث المراجعات لملف، ما يؤدي إلى استبدال المراجعات السابقة. تتيح "العروض التقديمية من Google" و"رسومات Google" إعادة النشر التلقائي فقط، ويجب ضبط السمة publishAuto على true. بالنسبة إلى ملفات "مواقع Google"، تكون قيمة publishAuto هي false دائمًا.

إذا تم إنشاء الملف في نطاق Google Workspace، تشير السمة publishedOutsideDomain إلى ما إذا كان يمكن لأي مستخدم الوصول إلى المراجعة أو ما إذا كان الوصول مقتصرًا على مستخدمي النطاق. بالنسبة إلى ملفات Sites ، يشير هذا الموقع إلى ما إذا كان هناك إذن type=anyone. لمزيد من المعلومات، يُرجى الاطّلاع على الحقل type في المرجع permissions.

يتم أيضًا التحكّم في النشر التلقائي من خلال مربّع الاختيار "إعادة النشر تلقائيًا عند إجراء تغييرات" في واجهة المستخدم لكل من "مستندات Google" و"جداول بيانات Google". لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"نماذج Google" لجميع المستخدمين.