تعديل تصنيف

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

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

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

تعديل كائنات التصنيفات

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

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

هذه بعض الكائنات العديدة التي تتحكّم في شكل التصنيف وطريقة عمله.

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

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

الفئة	الوصف
الإنشاء	إضافة كائنات
التعديل	تعديل خصائص معيّنة لكائن
التفعيل	تفعيل الكائنات
الإيقاف	إيقاف الكائنات
الحذف	إزالة الكائنات

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

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

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

نوع الطلب
خصائص التصنيف	التعديل 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 قبل أن تصبح التغييرات مرئية للمستخدمين. لمزيد من المعلومات، راجِع مراحل نشاط التصنيف.