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:
- .
- Crea un'etichetta (
create()
): l'etichetta viene creata e archiviata in una 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, ancor prima della pubblicazione, è archiviata in un database e il parametro la revisione viene incrementata. - Pubblica un'etichetta (
publish()
): lo stato dell'etichetta èPUBLISHED
e possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione. - (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 statoPUBLISHED
con significatohasUnpublishedChanges=true
ci sono modifiche alle bozze, che però non sono disponibili per gli utenti. Ogni aggiornamento la revisione viene incrementata. - (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. - 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. - Attiva un'etichetta (
enable()
): l'etichetta viene riportata allo statoPUBLISHED
e gli utenti possono applicarla. La pubblicazione dell'etichetta ne incrementa la revisione. - 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.