إنشاء تصنيف ونشره

وتوضّح هذه الصفحة كيفية إنشاء تصنيف ونشره.

إنشاء تصنيف

لإنشاء تصنيف، استخدِم الإجراء create في المجموعة labels. ويمكن أن تحتوي التصنيفات اختياريًا على علامة Fields واحدة أو أكثر.

عليك أيضًا تحديد ما يلي:

• علامة LabelType:

• تصنيف title من خلال طريقة property.

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

ينشئ هذا المثال تصنيفًا عاديًا للمشرف مع عنوان محدّد وتصنيف واحد SelectionOptions Field مع 2 Choices.

Python

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

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

يتم إنشاء التصنيف في UNPUBLISHED_DRAFT State. يجب أن يكون PUBLISHED للاستخدام في الملفات وأن يكون مرئيًا للمستخدمين. لمزيد من المعلومات، اطّلع على مراحل نشاط التصنيف.

حدود التصنيفات

تنطبق الحدود التالية عند إنشاء التصنيفات وتطبيقها:

• التصنيفات العادية: 150
• الحقول لكل تصنيف: 10
• التصنيفات التي طبّقها المستخدم لكل ملف: 5

العمل على الحقول في التصنيفات

Field Type	الإجراءات التي يمكن للمستخدمين اتّخاذها	اعتبارات التنسيق وحدوده
SelectionOptions	تحديد خيار واحد أو أكثر من قائمة	الحد الأقصى لعدد الخيارات المتاحة هو 200. الحد الأقصى لعدد الاختيارات للملف هو 10 خيارات، على النحو الذي تم ضبطه في ListOptions.
IntegerOptions	يُرجى إدخال قيمة رقمية.	يُسمَح فقط بالأرقام الصحيحة.
DateOptions	اختيار تاريخ من التقويم	(اختياري) يمكن ضبط Date format على "طويل: الشهر ي ي، س س س س" أو "قصير: ش ش/ي ي/س س"
TextOptions	إدخال نص في مربّع نص	الحد الأقصى لعدد الأحرف المسموح به هو 100.
UserOptions	اختَر مستخدمًا واحدًا أو أكثر من جهات اتصال Google Workspace.	الحد الأقصى لعدد إدخالات المستخدمين في ملف هو 10 إدخالات في ListOptions.

نشر تصنيف

تتيح لك labels API نشر مسودة تصنيف بعد اكتماله.

لنشر تصنيف، استخدِم طريقة publish وحدِّد ما يلي:

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

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

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

Python

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

Node.js

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

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

القيود عند نشر التصنيفات

• بعد نشر التصنيف، لا يمكن أن يعود إلى حالته الأصلية في المسودة. لمزيد من المعلومات، يُرجى الاطّلاع على مراحل نشاط التصنيف.

• يؤدي نشر تصنيف إلى إنشاء نسخة سابقة منشورة حديثًا. يتم حذف جميع مراجعات المسودة السابقة. يتم الاحتفاظ بالمراجعات المنشورة سابقًا ولكنها تخضع للحذف التلقائي حسب الحاجة.

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

  • يتم حذف التصنيف مباشرة. (يجب إيقافه أولاً، ثم حذفه).
  • تم تغيير Field.FieldType.
  • تؤدي التحديثات في خيارات التحقق من صحة الحقل إلى رفض عنصر تم قبوله مسبقًا.
  • انخفاض في الحد الأقصى من الإدخالات.