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:

Etiketlerin yaşam döngüsü diyagramı.
Şekil 3. Bir etiketin yaşam döngüsü
  1. Etiket oluştur (create()): Etiket revision_id=1 olarak oluşturulur ve veritabanında depolanır. Etiketin durumu UNPUBLISHED_DRAFT. Bu durumda:
    • Kullanıcılar etiketi görüntüleyemez
    • Kullanıcılar etiketi Drive öğelerine uygulayamaz.
  2. (İsteğe bağlı) Etiketi, alanı veya seçimi güncelleme (delta()): Her güncelleme, yayınlanmadan önce bile bir veritabanında depolanır ve etiketin düzeltmesi artırılır.
  3. Etiket yayınla (publish()): Etiketin durumu PUBLISHED olur ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması, düzeltme işlemini artırır.
  4. (İsteğe bağlı) Etiketi, alanı veya seçimi (delta()) güncelleyin: Etiket, alan veya seçim güncellenir ve taslak etiket olarak bir veritabanında depolanır. Etiketin durumu PUBLISHED ve hasUnpublishedChanges=true şeklindedir. Bu, taslak değişiklikler olduğu anlamına gelir ancak kullanıcılar tarafından kullanılamaz. Her güncelleme, etiketin revizyonunu artırır.
  5. (İsteğe bağlı) Etiket yayınlayın (publish()) - Varsa en güncel taslak yayınlanır. Etiket PUBLISHED durumundadır ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması sürümün sayısını artırır.
  6. Etiketi devre dışı bırak (disable()): Etiket DISABLED durumundadır, ancak kullanıcılar etiketi API aracılığıyla uygulayabilir. Ancak devre dışı bırakılan bir etiket, gösterilecek şekilde yapılandırılmadığı sürece kullanıcı arayüzünde gösterilmez. Etiketin kullanımdan kaldırılması, revizyonunu artırır.
  7. Etiketi etkinleştir (enable()): Etiket PUBLISHED durumuna döndürülür ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması, düzeltme işlemini artırır.
  8. Etiketi sil (delete()): Etiket DELETED durumundadır ve uygulanamaz. Silinen etiketler belirli bir süre sonra tamamen silinir.

Bir etikete yapılan her güncellemenin etiketin düzeltmesini artırdığının vurgulanması önemlidir. Etiket daha önce yayınlanmışsa n güncellemesinden sonra tekrar yayınlanması, yayınlanan düzeltme numarasının düzeltme + n + 1 ardışık güncelleme sayısı olduğu anlamına gelir.