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

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

إنشاء تصنيف

لإنشاء تصنيف، استخدِم طريقة 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.
  • تؤدي التعديلات على خيارات التحقّق من صحة الحقول إلى رفض بعض القيم التي كانت مقبولة في السابق.
  • انخفاض في الحدّ الأقصى لعدد الإدخالات