تعديل تصنيف

يمكنك تعديل تصنيف واحد من خلال تطبيق مجموعة من طلبات التعديل التي تؤدي إلى إنشاء مسودة جديدة. على سبيل المثال، يمكنك تعديل سمة لتصنيف حالي (وصف التصنيف) أو يمكنك إضافة Field جديد إلى التصنيف.

يعمل تعديل التصنيف كتعديل مجمّع لأنّ الطريقة تتضمّن قائمة بعناصر التعديل Request. ويتم إجراء التعديلات وفقًا للترتيب نفسه المحدّد في طلب الدفعة. يتم تطبيق التعديلات في التعديل المجمّع بشكل ذري. وهذا يعني أنّه في حال عدم نجاح أي طلب في المجموعة، لن تنجح عملية التعديل بأكملها ولن يتم تطبيق أي من التغييرات (التي قد تكون مرتبطة). يتم ترك التصنيف بدون تغيير.

في حال نجاح التعديل، يجب نشر المسودّة الناتجة قبل أن يمكن استخدام التغييرات مع أي عنصر في Drive.

تعديل عناصر التصنيف

يتضمّن التصنيف العديد من أنواع العناصر الأخرى التي يمكن تعديلها، مثل:

• خصائص التصنيف
• الحقول وأنواع الحقول
• خيارات التحديد وخصائص خيار التحديد

في ما يلي بعض العناصر العديدة التي تتحكّم في مظهر العلامة وعملها.

فئات العمليات

يمكن تجميع العمليات التالية التي تتيحها الطريقة labels.delta في الفئات العامة التالية:

الفئة	الوصف
الإنشاء	أضِف عناصر.
تحديث	تعديل بعض خصائص أحد العناصر
تفعيل	فعِّل العناصر.
إيقاف	إيقاف العناصر
حذف	إزالة العناصر

يتم استخدام هذه الفئات في القسم التالي لوصف سلوك عمليات معيّنة.

طلبات التعديل

تعمل طريقة labels.delta من خلال أخذ عنصر واحد أو أكثر من عناصر Request، ويحدّد كل عنصر نوعًا واحدًا من الطلبات المطلوب تنفيذها. هناك العديد من أنواع الطلبات المختلفة. في ما يلي تفصيل لأنواع الطلبات، مصنّفة في فئات مختلفة.

نوع الطلب
خصائص التصنيف	تحديث UpdateLabelPropertiesRequest
الحقل	الإنشاء CreateFieldRequest تحديث UpdateFieldPropertiesRequest UpdateFieldTypeRequest تفعيل EnableFieldRequest إيقاف DisableFieldRequest حذف DeleteFieldRequest
اختيار التحديد	الإنشاء CreateSelectionChoiceRequest تحديث UpdateSelectionChoicePropertiesRequest تفعيل EnableSelectionChoiceRequest إيقاف DisableSelectionChoiceRequest حذف DeleteSelectionChoiceRequest

أقنعة الحقول

تتطلّب العديد من الطلبات من النوع "تعديل" و "إيقاف" FieldMask. هذه قائمة مفصولة بفواصل للحقول التي تريد تعديلها مع ترك الحقول الأخرى بدون تغيير. القناع مطلوب للتأكّد من تعديل الحقول التي تريد تعديلها فقط. يجب تحديد حقل واحد على الأقل.

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

.

مثال

لتعديل تصنيف، استخدِم طريقة delta في مجموعة labels.

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

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

• تمثّل Request التعديلات السارية على التصنيف.

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

• Field واحد أو أكثر

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

• LabelView هي LABEL_VIEW_FULL لضبط طريقة عرض "الموارد" المطبَّقة على الردود التي تتضمّن تصنيفات. تعرض LABEL_VIEW_FULL جميع الحقول الممكنة.

يستخدم هذا المثال ID لتعديل التصنيف الصحيح.

Python

body = {
'use_admin_access': True,
'requests': [{
  'update_label': {
    'properties': {
      'title': 'TITLE'
    },
    'update_mask': {
      'paths': ['title']
    }
  },
}, {
  'create_field': {
    'field': {
      'properties': {
        'display_name': 'DISPLAY_NAME'
      },
      'text_options': {}
    }
  }
}],
'view': 'LABEL_VIEW_FULL'
}
response = service.labels().delta(
  body=body,
  name='labels/ID').execute()

Node.js

var body = {
  'use_admin_access': true,
  'requests': [{
    'update_label': {
      'properties': {
        'title': 'TITLE'
      },
      'update_mask': {
        'paths': ['title']
      }
    },
  }, {
    'create_field': {
      'field': {
        'properties': {
          'display_name': 'DISPLAY_NAME'
        },
        'text_options': {}
      }
    }
  }],
  'view': 'LABEL_VIEW_FULL'
};
service.labels.delta({
  'resource': body,
  'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

يتم تعديل التصنيف أو الحقل أو الخيار، ويتم زيادة رقم تعريف مراجعة التصنيف، ويتم تخزين التصنيف في قاعدة بيانات كتصنيف مسودة. يتضمّن التصنيف State PUBLISHED مع hasUnpublishedChanges=true، ما يعني أنّ هناك تغييرات في المسودة، ولكنها غير متاحة للمستخدمين. يجب أن يكون التصنيف المعدَّل PUBLISHED قبل أن تصبح التغييرات مرئية للمستخدمين. لمزيد من المعلومات، يُرجى الاطّلاع على دورة حياة التصنيف.