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

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

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

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

تحديد النُسخ التي يجب حفظها من الحذف التلقائي

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

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

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

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

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

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

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

تعرض الطريقة البيانات الوصفية للنسخة كمثال لمصدر revisions. إذا قدّمت المَعلمة alt=media، سيتضمّن الردّ محتويات النسخة في نص الردّ. لتنزيل ملف ثنائي، يُرجى الاطّلاع على المقالة تنزيل محتوى ملف ثنائي في إصدار سابق.

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

عرض نُسخ ملف

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

**ملاحظة مهمة:** قد تكون قائمة النُسخ التي تعرضها هذه الطريقة غير مكتملة للملفات التي تتضمّن سجلّ نُسخ كبيرًا، بما في ذلك "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" التي يتم تعديلها بشكل متكرّر. قد يتم حذف النُسخ القديمة من الردّ، ما يعني أنّ النسخة الأولى التي يتم عرضها قد لا تكون أقدم نسخة حالية. قد يكون سجلّ النُسخ السابقة الظاهر في واجهة مستخدم Drive أكثر اكتمالاً من القائمة التي تعرضها Drive API.

يمكنك ضبط مَعلمات طلب البحث التالية لتخصيص تقسيم النُسخ على صفحات أو فلترتها:

• pageSize: الحدّ الأقصى لعدد النُسخ التي سيتم عرضها في كل صفحة.

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

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

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

تعرض الطريقة مثالاً لمصدر revisions.

تنزيل نسخة

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

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

حذف نسخة من ملف

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

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

نشر نسخة

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

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

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

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

مواضيع ذات صلة

• تنزيل الملفات وتصديرها
• الأدوار والأذونات