Etichette, campi e scelte passano attraverso stati specifici nel corso della loro vita. Inoltre, le etichette potrebbero avere revisioni diverse. Il seguente diagramma mostra il ciclo di vita delle etichette, inclusa la revisione:
- Crea un'etichetta (
create()
): l'etichetta viene creata e archiviata in un database comerevision_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.
- (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. - Pubblica un'etichetta (
publish()
): l'etichetta è nello statoPUBLISHED
e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione. - (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 di bozza. L'etichetta ha lo statoPUBLISHED
conhasUnpublishedChanges=true
, il che significa che sono presenti modifiche in bozza, che però non sono disponibili per gli utenti. Ogni aggiornamento incrementa la revisione dell'etichetta. - (Facoltativo) Pubblica un'etichetta (
publish()
): se disponibile, viene pubblicata la bozza più recente. L'etichetta è nello statoPUBLISHED
e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la versione. - Disabilita un'etichetta (
disable()
): l'etichetta è nello statoDISABLED
, anche se gli utenti possono applicarla tramite l'API. Tuttavia, un'etichetta disabilitata non viene mostrata in una UI a meno che non sia configurata per essere mostrata. La deprecazione dell'etichetta ne incrementa la revisione. - Abilita un'etichetta (
enable()
): l'etichetta viene restituita allo statoPUBLISHED
e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione. - Elimina un'etichetta (
delete()
): lo stato dell'etichetta èDELETED
e non può essere applicata. Le etichette eliminate verranno 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.