تمر التسميات والحقول والخيارات بحالات محددة طوال حياتهم. بالإضافة إلى ذلك، قد يكون للتصنيفات مراجعات مختلفة. يُظهر الرسم التخطيطي التالي دورة حياة التسمية، بما في ذلك مراجعة:
- إنشاء تصنيف (
create()
): يتم إنشاء التصنيف وتخزينه في قاعدة البيانات باسمrevision_id=1
. يكون للتصنيف الحالةUNPUBLISHED_DRAFT
. في هذه الحالة:- لا يمكن للمستخدمين الاطّلاع على التصنيف
- لا يمكن للمستخدمين تطبيق التصنيف على عناصر Drive.
- (اختياري) تعديل تصنيف أو حقل أو اختيار (
delta()
): مع كل تعديل حتى قبل نشره، يتم تخزينها في قاعدة بيانات، تتزايد المراجعة. - نشر تصنيف (
publish()
): يتضمن التصنيف حالةPUBLISHED
يمكن للمستخدمين تطبيق التصنيف. يؤدي نشر التصنيف إلى زيادة مراجعته. - (اختياري) تعديل تصنيف أو حقل أو خيار (
delta()
): التصنيف، أو خيار تحديث وتخزينه في قاعدة بيانات كتصنيف مسودة. تشير رسالة الأشكال البيانية حالة التصنيف هيPUBLISHED
وبمعنىhasUnpublishedChanges=true
هناك تغييرات في المسودة، لكنها غير متاحة للمستخدمين. كل تحديث يزيد من مراجعة التصنيف. - (اختياري) نشر تصنيف (
publish()
): أحدث تصنيف إذا كان متاحًا تم نشر المسودة. يتضمّن التصنيف حالةPUBLISHED
، ويمكن للمستخدمين إجراء ما يلي: وتطبيق التسمية. يؤدي نشر التصنيف إلى زيادة إصداره. - إيقاف تصنيف (
disable()
): يكون للتصنيف حالةDISABLED
على الرغم من أنّ المستخدمين يمكنهم تطبيق التصنيف عبر واجهة برمجة التطبيقات. ومع ذلك، فإنّ التصنيف "غير مفعَّل" ولا تظهر في واجهة مستخدم ما لم يتم إعدادها بحيث يتم عرضها. إيقاف التصنيف نهائيًا يزيد من مراجعته. - تفعيل تصنيف (
enable()
): يتم إرجاع التصنيف إلى حالةPUBLISHED
. ويمكن للمستخدمين تطبيق التصنيف. يؤدي نشر التصنيف إلى زيادة مراجعته. - حذف تصنيف (
delete()
): يكون للتصنيف حالةDELETED
و تطبيق. وتتم إزالة التصنيفات المحذوفة نهائيًا في النهاية.
ومن المهم التأكيد على أن كل تحديث يتم إجراؤه على أي تصنيف يؤدي إلى زيادة المراجعة. وفي حال سبق أن تم نشر التصنيف، يمكنك إعادة نشره. بعد تعديل n، يعني ذلك أن رقم النسخة السابقة المنشور هو مراجعة + n + 1. عدد التحديثات المتتالية.