Ciclo di vita di un'etichetta

Le etichette, i campi e le scelte attraversano stati specifici durante il loro ciclo di vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita delle etichette, 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 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 vengono aggiornati e archiviati in un database come etichetta bozza. L'etichetta ha lo stato PUBLISHED con hasUnpublishedChanges=true, il che significa che sono presenti 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ù recente. L'etichetta ha lo stato PUBLISHED e gli utenti possono applicarla. 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. La rimozione dell'etichetta ne incrementa la revisione.
  7. Attiva un'etichetta (enable()) : l'etichetta torna 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 rimosse definitivamente.

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