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, 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 una 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, ancor prima della pubblicazione, è archiviata in un database e il parametro la revisione viene incrementata.
  3. Pubblica un'etichetta (publish()): lo stato dell'etichetta è PUBLISHED e possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione.
  4. (Facoltativo) Aggiorna un'etichetta, un campo o un'opzione (delta()): l'etichetta, viene aggiornato e memorizzato in un database come etichetta bozza. La l'etichetta ha lo stato PUBLISHED con significato hasUnpublishedChanges=true ci sono modifiche alle bozze, che però non sono disponibili per gli utenti. Ogni aggiornamento la revisione viene incrementata.
  5. (Facoltativo) Pubblica un'etichetta (publish()): se disponibile, la più recente la bozza è stata pubblicata. Lo stato dell'etichetta è PUBLISHED e gli utenti possono e applicarla. La pubblicazione dell'etichetta ne incrementa la versione.
  6. Disattiva un'etichetta (disable()): lo stato dell'etichetta è DISABLED ma gli utenti possono applicarla tramite l'API. Tuttavia, un'etichetta disattivata non viene mostrato nell'interfaccia utente a meno che non sia configurato per essere mostrato. Ritiro dell'etichetta ne incrementa la 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()): lo stato dell'etichetta è DELETED ed è non possono essere applicati. Le etichette eliminate vengono poi eliminate definitivamente.

È importante sottolineare che ogni aggiornamento a un'etichetta incrementa il valore revisione. Se l'etichetta è già stata pubblicata, verrà pubblicata di nuovo dopo n aggiornamenti significa che il numero di revisione pubblicato è revisione + n + 1 numero di aggiornamenti successivi.