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

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

إنشاء تصنيف

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

يجب أيضًا تحديد ما يلي:

• LabelType

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

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

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

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

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

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

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

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