تعديل تصنيف

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

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

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

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

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

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

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

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

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

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

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

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

أقنعة الحقول

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

مثال

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

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

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

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

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

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

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

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

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

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()

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