Ciclo di vita di un'etichetta

Etichette, campi e scelte passano attraverso stati specifici per tutta la vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita delle etichette, incluso il controllo delle revisioni:

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()): lo stato dell'etichetta è 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 bozza. L'etichetta ha lo stato PUBLISHED con hasUnpublishedChanges=true, il che significa che sono state apportate modifiche a una bozza, ma 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. Lo stato dell'etichetta è PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la versione.
6. Disabilita un'etichetta (disable()): lo stato dell'etichetta è DISABLED, sebbene gli utenti possano applicarla tramite l'API. Tuttavia, un'etichetta disabilitata non viene mostrata nella UI a meno che non sia configurata per essere mostrata. Il ritiro dell'etichetta incrementa la sua revisione.
7. Attiva un'etichetta (enable()): l'etichetta viene riportata allo stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
8. Elimina un'etichetta (delete()): l'etichetta ha lo stato DELETED e non può essere applicata. Le etichette eliminate vengono poi 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.