Ciclo di vita di un'etichetta

Etichette, campi e scelte passano attraverso stati specifici nel corso della loro vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita delle etichette, inclusa la revisione:

Figura 3. Ciclo di vita di un'etichetta

1. Crea un'etichetta (create()): l'etichetta viene creata e archiviata in un database come revision_id=1. Lo stato dell'etichetta è UNPUBLISHED_DRAFT. In questo stato:
   • Gli utenti non possono visualizzare l'etichetta
   • Gli utenti non possono applicare l'etichetta agli elementi di Drive.
2. (Facoltativo) Aggiorna un'etichetta, un campo o una scelta (delta()): ogni aggiornamento, anche prima della pubblicazione, viene archiviato in un database e la revisione dell'etichetta viene incrementata.
3. Pubblica un'etichetta (publish()): l'etichetta è nello stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
4. (Facoltativo) Aggiorna un'etichetta, un campo o una scelta (delta()): l'etichetta, il campo o la scelta vengono aggiornati e archiviati in un database come etichetta di bozza. L'etichetta ha lo stato PUBLISHED con hasUnpublishedChanges=true, il che significa che sono presenti modifiche in bozza, che però non sono disponibili per gli utenti. Ogni aggiornamento incrementa la revisione dell'etichetta.
5. (Facoltativo) Pubblica un'etichetta (publish()): se disponibile, viene pubblicata la bozza più recente. L'etichetta è nello stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la versione.
6. Disabilita un'etichetta (disable()): l'etichetta è nello stato DISABLED, anche se gli utenti possono applicarla tramite l'API. Tuttavia, un'etichetta disabilitata non viene mostrata in una UI a meno che non sia configurata per essere mostrata. La deprecazione dell'etichetta ne incrementa la revisione.
7. Abilita un'etichetta (enable()): l'etichetta viene restituita allo stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
8. Elimina un'etichetta (delete()): lo stato dell'etichetta è DELETED e non può essere applicata. Le etichette eliminate verranno eliminate definitivamente.

È importante sottolineare che ogni aggiornamento di un'etichetta incrementa la sua revisione. Inoltre, se l'etichetta è già stata pubblicata, pubblicarla di nuovo dopo n aggiornamenti significa che il numero di revisione pubblicata è revisione + n + 1 numero di aggiornamenti successivi.