چرخه عمر برچسب

برچسب‌ها، فیلدها و انتخاب‌ها در طول حیات خود، حالت‌های خاصی را طی می‌کنند. علاوه بر این، برچسب‌ها ممکن است ویرایش‌های مختلفی داشته باشند. نمودار زیر چرخه حیات برچسب‌ها، از جمله ویرایش را نشان می‌دهد:

1. ایجاد یک برچسب ( create() ) — برچسب ایجاد شده و با شناسه revision_id=1 در پایگاه داده ذخیره می‌شود. برچسب دارای وضعیت UNPUBLISHED_DRAFT است. در این وضعیت:
   • کاربران نمی‌توانند برچسب را مشاهده کنند
   • کاربران نمی‌توانند این برچسب را روی موارد Drive اعمال کنند.
2. (اختیاری) به‌روزرسانی یک برچسب، فیلد یا انتخاب ( delta() ) — هر به‌روزرسانی، حتی قبل از انتشار، در یک پایگاه داده ذخیره می‌شود و نسخهٔ برچسب یک واحد افزایش می‌یابد.
3. انتشار یک برچسب ( publish() ) — برچسب حالت PUBLISHED ) دارد و کاربران می‌توانند آن را اعمال کنند. انتشار برچسب، تعداد ویرایش‌های آن را افزایش می‌دهد.
4. (اختیاری) به‌روزرسانی یک برچسب، فیلد یا انتخاب ( delta() ) — برچسب، فیلد یا انتخاب به‌روزرسانی شده و به عنوان یک برچسب پیش‌نویس در پایگاه داده ذخیره می‌شود. این برچسب دارای وضعیت PUBLISHED با hasUnpublishedChanges=true است، به این معنی که تغییرات پیش‌نویس وجود دارد، اما برای کاربران در دسترس نیستند. هر به‌روزرسانی، ویرایش برچسب را افزایش می‌دهد.
5. (اختیاری) انتشار یک برچسب ( publish() ) — در صورت وجود، جدیدترین پیش‌نویس منتشر می‌شود. برچسب حالت PUBLISHED دارد و کاربران می‌توانند برچسب را اعمال کنند. انتشار برچسب، نسخه آن را افزایش می‌دهد.
6. غیرفعال کردن یک برچسب ( disable() ) — برچسب حالت DISABLED دارد، اگرچه کاربران می‌توانند این برچسب را از طریق API اعمال کنند. با این حال، یک برچسب غیرفعال در رابط کاربری نمایش داده نمی‌شود، مگر اینکه برای نمایش پیکربندی شده باشد. غیرفعال کردن برچسب، تعداد دفعات ویرایش آن را افزایش می‌دهد.
7. فعال کردن یک برچسب ( enable() ) — برچسب به حالت PUBLISHED ) برمی‌گردد و کاربران می‌توانند برچسب را اعمال کنند. انتشار برچسب، تعداد دفعات ویرایش آن را افزایش می‌دهد.
8. حذف یک برچسب ( delete() ) — برچسب حالت DELETED دارد و قابل اعمال نیست. برچسب‌های حذف شده در نهایت پاک می‌شوند.

تأکید بر این نکته مهم است که هر به‌روزرسانی یک برچسب، تعداد نسخه‌های آن برچسب را افزایش می‌دهد. و اگر برچسب قبلاً منتشر شده باشد، انتشار مجدد آن پس از n به‌روزرسانی به این معنی است که شماره نسخه‌های منتشر شده آن برابر با تعداد نسخه‌های به‌روزرسانی‌های متوالی + n + 1 است.