تعديل تصنيف

يمكنك تحديث تصنيف واحد من خلال تطبيق مجموعة من طلبات التحديث التي تؤدي إلى مراجعة مسودة جديدة. على سبيل المثال، يمكنك تعديل سمة تصنيف حالية (وصف التصنيف) أو إضافة 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 قبل أن تصبح التغييرات مرئية للمستخدمين. لمزيد من المعلومات، اطّلع على مراحل نشاط التصنيف.