Ciclo di vita di un'etichetta

Le etichette, i campi e le scelte attraversano stati specifici nel corso del loro ciclo di vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita dell'etichetta, inclusa la revisione:

1. Crea un'etichetta (create()): l'etichetta viene creata e archiviata in un database come revision_id=1. L'etichetta ha lo stato 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 ha lo 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 viene aggiornato e archiviato in un database come bozza di etichetta. L'etichetta ha lo stato PUBLISHED, dove hasUnpublishedChanges=true indica che esistono modifiche alla 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ù aggiornata. L'etichetta ha lo stato PUBLISHED e gli utenti possono applicarlo. La pubblicazione dell'etichetta ne incrementa la versione.
6. Disattivare un'etichetta (disable()): l'etichetta ha lo stato DISABLED, anche se gli utenti possono applicarla tramite l'API. Tuttavia, un'etichetta disattivata non viene visualizzata in un'interfaccia utente, a meno che non sia configurata per essere visualizzata. Il ritiro dell'etichetta incrementa la relativa revisione.
7. Attiva un'etichetta (enable()): l'etichetta viene restituita a uno stato PUBLISHED e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
8. Eliminare un'etichetta (delete()): l'etichetta ha lo stato DELETED e non può essere applicata. Le etichette eliminate vengono eliminate definitivamente.

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