Etiket yaşam döngüsü

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

Etiketler yaşam döngüsü diyagramı.
Şekil 3. Bir etiketin yaşam döngüsü
  1. Etiket oluştur (create()): Etiket oluşturulur ve revision_id=1 şeklinde bir veritabanında depolanır. Etiketin durumu UNPUBLISHED_DRAFT. Bu durumda:
    • Kullanıcılar etiketi görüntüleyemiyor
    • Kullanıcılar bu etiketi Drive öğelerine uygulayamaz.
  2. (isteğe bağlı) Bir etiketi, alanı veya seçeneği güncelleme (delta()): Her güncelleme, yayınlanmadan önce bile bir veritabanında depolanır ve etiketin düzeltme işlemi artar.
  3. Etiket yayınlama (publish()): Etiketin durumu PUBLISHED olur 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çeneği güncelleme (delta()): Etiket, alan veya seçenek güncellenir ve bir veritabanında taslak etiket olarak depolanır. Etiketin durumu PUBLISHED ve hasUnpublishedChanges=true ise taslak değişiklikler olduğu anlamına gelir ancak bu değişiklikler kullanıcılara sunulmaz. Her güncelleme, etiketin düzeltmesini artırır.
  5. (isteğe bağlı) Etiket yayınla (publish()): Kullanılabiliyorsa en güncel taslak yayınlanır. Etiket, PUBLISHED durumundadır ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması sürüm oranını artırır.
  6. Etiketi devre dışı bırak (disable()): Etiketin durumu DISABLED olsa da kullanıcılar etiketi API aracılığıyla uygulayabilir. Ancak devre dışı bırakılan bir etiket, gösterilecek şekilde yapılandırılmadıkça kullanıcı arayüzünde gösterilmez. Etiketin kullanımdan kaldırılması, revizyonunu artırır.
  7. Etiket etkinleştir (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 olduğu için uygulanamaz. Silinen etiketler sonunda kalıcı olarak silinir.

Bir etikette yapılan her güncellemenin, etikette yapılan düzeltme sayısını artıracağının vurgulanması önemlidir. Etiket zaten yayınlanmışsa n güncellemeden sonra tekrar yayınlanması, yayınlanan düzeltme numarasının düzeltme + n + 1 ardışık güncelleme olduğu anlamına gelir.