Ciclo de vida de las etiquetas

Las etiquetas, los campos y las opciones pasan por estados específicos a lo largo de su ciclo de vida. Además, las etiquetas pueden tener diferentes revisiones. En el siguiente diagrama, se muestra el ciclo de vida de las etiquetas, incluida la administración de versiones:

Figura 3: Ciclo de vida de una etiqueta

1. Crear una etiqueta (create()) : La etiqueta se crea y se almacena en una base de datos como revision_id=1. La etiqueta tiene el estado UNPUBLISHED_DRAFT. En este estado, ocurre lo siguiente:
   • Los usuarios no pueden ver la etiqueta.
   • Los usuarios no pueden aplicar la etiqueta a los elementos de Drive.
2. (opcional) Actualizar una etiqueta, un campo o una opción (delta()) : Cada actualización, incluso antes de que se publique, se almacena en una base de datos, y se incrementa la revisión de la etiqueta.
3. Publicar una etiqueta (publish()) : La etiqueta tiene el estado PUBLISHED y los usuarios pueden aplicarla. Cuando se publica la etiqueta, se incrementa su revisión.
4. (opcional) Actualizar una etiqueta, un campo o una opción (delta()) : La etiqueta, el campo o la opción se actualizan y se almacenan en una base de datos como una etiqueta de borrador. La etiqueta tiene el estado PUBLISHED con hasUnpublishedChanges=true, lo que significa que hay cambios en el borrador, pero no están disponibles para los usuarios. Cada actualización incrementa la revisión de la etiqueta.
5. (opcional) Publicar una etiqueta (publish()) : Si está disponible, se publica el borrador más reciente. La etiqueta tiene el estado PUBLISHED y los usuarios pueden aplicarla. Cuando se publica la etiqueta, se incrementa su versión.
6. Inhabilitar una etiqueta (disable()) : La etiqueta tiene el estado DISABLED, aunque los usuarios pueden aplicarla a través de la API. Sin embargo, una etiqueta inhabilitada no se muestra en una IU, a menos que se configure para que se muestre. Cuando se inhabilita la etiqueta, se incrementa su revisión.
7. Habilitar una etiqueta (enable()) : La etiqueta vuelve a un estado PUBLISHED y los usuarios pueden aplicarla. Cuando se publica la etiqueta, se incrementa su revisión.
8. Borrar una etiqueta (delete()) : La etiqueta tiene un estado DELETED y no se puede aplicar. Las etiquetas borradas se quitan con el tiempo.

Es importante destacar que cada actualización de una etiqueta incrementa su revisión. Además, si la etiqueta ya se publicó, volver a publicarla después de n actualizaciones significa que su número de revisión publicada es revisión + n + 1 número de actualizaciones sucesivas.