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, es posible que las etiquetas tengan diferentes revisiones. En el siguiente diagrama, se muestra el ciclo de vida de las etiquetas, incluido el control de versiones:

Diagrama del ciclo de vida de las etiquetas.
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) Actualiza 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) Actualiza 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 de PUBLISHED, en el que hasUnpublishedChanges=true significa que hay cambios en borrador, pero no están disponibles para los usuarios. Cada actualización incrementa la revisión de la etiqueta.
  5. (Opcional) Publica 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, no se muestra una etiqueta inhabilitada en una IU, a menos que se configure para que se muestre. Cuando se da de baja 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 el estado DELETED y no se puede aplicar. Las etiquetas borradas se quitan de forma permanente 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.