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

تصف هذه الصفحة كيفية تنفيذ هذه المهام التي تتضمن تصنيفات:

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

إيقاف تصنيف

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

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

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