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

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

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

إيقاف تصنيف

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

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

لإيقاف تصنيف منشور، استخدِم الطريقة 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 ويتمّ زيادة معرّف النسخة السابقة للتصنيف. لا يمكن تطبيق التصنيف، ويتم حذف التصنيفات المحذوفة نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على رحلة التصنيف.