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, revizyon da dahil olmak üzere etiket yaşam döngüsü gösterilmektedir:

Etiketlerin yaşam döngüsü diyagramı.
3.şekil Etiketin 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. (İsteğe bağlı) Etiketi, alanı veya seçimi güncelleyin (delta()): Yayınlanmadan önce bile her güncelleme 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. Etiketin yayınlanması, revizyonunu artırır.
  4. (İsteğe bağlı) Etiketi, alanı veya seçimi güncelleme (delta()): Etiket, alan veya seçim güncellenir ve taslak etiket olarak bir veritabanında saklanır. Etiket, PUBLISHED durumundadır. hasUnpublishedChanges=true, taslak değişiklikler olduğunu ancak bunların kullanıcılar tarafından kullanılamadığını gösterir. Her güncelleme, etiketin revizyonunu artırır.
  5. (isteğe bağlı) Etiket yayınlama (publish()): Varsa en güncel taslak yayınlanır. Etiketin durumu PUBLISHED ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması, sürümünü artırır.
  6. Etiketi devre dışı bırakma (disable()): Etiket, kullanıcılar etiketi API aracılığıyla uygulayabilse de DISABLED durumundadır. 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. Etiketi etkinleştirme (enable()): Etiket PUBLISHED durumuna geri döner ve kullanıcılar etiketi uygulayabilir. Etiketin yayınlanması, revizyonunu artırır.
  8. Etiket silme (delete()): Etiketin durumu DELETED ve uygulanamıyor. Silinen etiketler belirli bir süre sonra temizlenir.

Bir etikette yapılan her güncellemenin etiketin revizyonunu artırdığını vurgulamak önemlidir. Etiket zaten yayınlandıysa n güncellemeden sonra tekrar yayınlanması, yayınlanan düzeltme numarasının düzeltme + n + 1 ardışık güncelleme sayısı olacağı anlamına gelir.