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

يوضّح هذا الدليل كيفية استخدام مورد 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. بعد ضبط مراجعة ملف كائن ثنائي كبير الحجم على "الاحتفاظ إلى الأبد"، يمكن تنزيلها أو حذفها فقط. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل نسخة معدَّلة أو حذف نسخة معدَّلة.

إذا كنت تستخدم الإصدار القديم من 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.

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

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

لتنزيل مراجعة لمحتوى ملف كبير الحجم أو لتصدير مراجعة لمحتوى مستند 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" لجميع المستخدمين.