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()): Kullanıcılar etiketi API aracılığıyla 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. 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.