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