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 la etiqueta, incluidas las revisiones:

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. Actualiza una etiqueta, un campo o una opción(delta()) (opcional): 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. Si publicas la etiqueta, se incrementa su revisión.
  4. Actualiza una etiqueta, un campo o una opción(delta()) (opcional): 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 publicará el borrador más reciente. La etiqueta tiene el estado PUBLISHED y los usuarios pueden aplicarla. Cuando publicas 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. Si das de baja la etiqueta, se incrementará su revisión.
  7. Habilita una etiqueta (enable()): La etiqueta se muestra en un estado PUBLISHED y los usuarios pueden aplicarla. Si publicas la etiqueta, se incrementa su revisión.
  8. Borrar una etiqueta (delete()): La etiqueta tiene un estado de DELETED y no se puede aplicar. Las etiquetas borradas se purgan con el tiempo.

Es importante enfatizar 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 publicado es la revisión + n + 1 cantidad de actualizaciones sucesivas.