تعديل تصنيف

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