إيقاف تصنيف وتفعيله وحذفه

توضّح هذه الصفحة كيفية تنفيذ المهام التالية المتعلقة بالتصنيفات:

  • إيقاف تصنيف
  • تفعيل تصنيف
  • حذف تصنيف

إيقاف تصنيف

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

بعد إيقاف هذا التصنيف، سيظل بإمكان المستخدمين تطبيقه من خلال واجهة برمجة التطبيقات. سيظل التصنيف ظاهرًا في المكان الذي تم تطبيقه فيه وفي نتائج البحث. يمكن حذف تصنيف تم إيقافه.

لإيقاف تصنيف منشور، استخدِم طريقة disable في مجموعة labels.

يجب أيضًا تحديد ما يلي:

  • مورد تصنيف يمثّل كل تصنيف يحتوي على مورد Name وID، وهو معرّف فريد عالميًا للتسمية.

  • useAdminAccess هو true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. يتأكّد الخادم من أنّ المستخدم هو مشرف على التصنيف قبل السماح له بالوصول إليه.

يستخدم هذا المثال السمة ID لإيقاف التصنيف الصحيح.

Python

service.labels().disable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.disable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

يحتوي التصنيف على State من DISABLED ويتم زيادة رقم تعريف النسخة السابقة من التصنيف. يمكن للمستخدمين تطبيق التصنيف من خلال واجهة برمجة التطبيقات. ومع ذلك، لا يظهر التصنيف "غير متاح" في واجهة المستخدم إلا إذا تم ضبط السمة showInApply الخاصة بالطريقة disabledPolicy.

تفعيل تصنيف

يؤدي تفعيل تصنيف غير مفعّل إلى استعادته إلى حالته المنشورة. ويؤدي ذلك إلى إنشاء نسخة منشورة جديدة استنادًا إلى النسخة المنشورة الحالية التي تم إيقافها. إذا كان هناك إصدار مسودّة حالي غير مفعَّل، سيتم إنشاء إصدار جديد استنادًا إلى هذه المسودّة وتفعيله. لمزيد من المعلومات، يُرجى الاطّلاع على دورة حياة التصنيف.

لتفعيل تصنيف تم إيقافه، استخدِم طريقة enable.

يجب أيضًا تحديد ما يلي:

  • مورد تصنيف يمثّل كل تصنيف يحتوي على مورد Name وID، وهو معرّف فريد عالميًا للتسمية.

  • useAdminAccess هو true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. يتأكّد الخادم من أنّ المستخدم هو مشرف على التصنيف قبل السماح له بالوصول إليه.

يستخدم هذا المثال ID لتفعيل التصنيف الصحيح.

Python

service.labels().enable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.enable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

يحتوي التصنيف على State من PUBLISHED ويتم زيادة رقم تعريف النسخة السابقة من التصنيف. يمكن للمستخدمين الاطّلاع على التسمية وتطبيقها على الملفات من خلال واجهة برمجة التطبيقات.

حذف تصنيف

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

لحذف تصنيف، عليك أولاً إيقافه ثم استخدام الطريقة delete.

يجب أيضًا تحديد ما يلي:

  • مورد تصنيف يمثّل كل تصنيف يحتوي على مورد Name وID، وهو معرّف فريد عالميًا للتسمية.

  • useAdminAccess هو true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. يتأكّد الخادم من أنّ المستخدم هو مشرف على التصنيف قبل السماح له بالوصول إليه.

يستخدم هذا المثال السمة ID لحذف التصنيف الصحيح.

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

service.labels.delete({
  'name': 'labels/ID',
  'use_admin_access': true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

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