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

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

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

إيقاف تصنيف

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

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

لإيقاف تصنيف منشور، استخدِم طريقة 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 method.

تفعيل تصنيف

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

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