Etiket yaşam döngüsü

Etiketler, alanlar ve seçenekler, yaşamları boyunca belirli durumlardan geçer. Ayrıca etiketlerin farklı düzeltmeleri olabilir. Aşağıdaki şemada, düzeltme dahil olmak üzere etiket yaşam döngüsü gösterilmektedir:

Etiket yaşam döngüsü şeması.
Şekil 3. Etiketlerin yaşam döngüsü
  1. Etiket oluşturma (create()): Etiket oluşturulur ve revision_id=1 olarak bir veritabanında saklanır. Etiketin durumu UNPUBLISHED_DRAFT. Bu durumda:
    • Kullanıcılar etiketi görüntüleyemez
    • Kullanıcılar etiketi Drive öğelerine uygulayamaz.
  2. (isteğe bağlı) Etiket, alan veya seçimi güncelleme (delta()): Her güncelleme, yayınlanmadan önce bile bir veritabanında depolanır ve etiketin revizyonu artırılır.
  3. Etiket yayınlama (publish()): Etiketin durumu PUBLISHED'dır ve kullanıcılar etiketi uygulayabilir. Etiketi yayınlamak, düzeltme sayısını artırır.
  4. (isteğe bağlı) Bir etiketi, alanı veya seçimi güncelleme (delta()): Etiket, alan veya seçim güncellenir ve taslak etiket olarak bir veritabanında saklanır. Etiketin durumu PUBLISHED ve hasUnpublishedChanges=true ile birliktedir. Bu, taslak değişikliklerin olduğu ancak kullanıcıların bunlara erişemediği anlamına gelir. Her güncelleme, etiketin düzeltmesini artırır.
  5. (isteğe bağlı) Etiket yayınlama (publish()): Mevcutsa en güncel taslak yayınlanır. Etiketin durumu PUBLISHED'tür ve kullanıcılar etiketi uygulayabilir. Etiket yayınlandığında sürüm numarası artar.
  6. Etiketi devre dışı bırakma (disable()): Kullanıcılar etiketi API üzerinden uygulayabilse de etiketin durumu DISABLED olur. Ancak devre dışı bırakılmış bir etiket, gösterilecek şekilde yapılandırılmadığı sürece kullanıcı arayüzünde gösterilmez. Etiketin desteğinin sonlandırılması, düzeltmesini artırır.
  7. Etiket etkinleştirme (enable()): Etiket PUBLISHED durumuna döndürülür ve kullanıcılar etiketi uygulayabilir. Etiketi yayınlamak, düzeltme sayısını artırır.
  8. Etiket silme (delete()): Etiketin durumu DELETED'dır ve uygulanamaz. Silinen etiketler zamanla temizlenir.

Bir etikette yapılan her güncellemenin, etiketin düzeltme sayısını artırdığını vurgulamak önemlidir. Etiket daha önce yayınlanmışsa n güncellemeden sonra yeniden yayınlandığında, yayınlanan düzeltme numarası düzeltme + n + art arda yapılan güncellemelerin sayısı olur.