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:

Diagramma del ciclo di vita delle etichette.
Figura 3. Ciclo di vita di un'etichetta
  1. Crea un'etichetta (create()): l'etichetta viene creata e memorizzata 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. Disattiva 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 ne incrementa la revisione. 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.