Ciclo de vida de las etiquetas

Las etiquetas, los campos y las opciones pasan por estados específicos a lo largo de su vida. Además, las etiquetas pueden tener revisiones diferentes. En el siguiente diagrama, se muestra el ciclo de vida de las etiquetas, 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. El estado de la etiqueta es UNPUBLISHED_DRAFT. En este estado:
    • Los usuarios no pueden ver la etiqueta
    • Los usuarios no pueden aplicar la etiqueta a 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 la revisión de la etiqueta aumenta.
  3. Publica una etiqueta (publish()): El estado de la etiqueta es PUBLISHED, y los usuarios pueden aplicarla. Publicar la etiqueta incrementa su revisión.
  4. (Opcional) Actualiza una etiqueta, un campo o una opción (delta()): La etiqueta, el campo o la elección se actualiza y se almacena 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 borrador, pero no están disponibles para los usuarios. Cada actualización aumenta la revisión de la etiqueta.
  5. Publica una etiqueta(publish()) (opcional): Si está disponible, se publica el borrador más reciente. El estado de la etiqueta es PUBLISHED, y los usuarios pueden aplicarla. La publicación de la etiqueta incrementa su versión.
  6. Inhabilita una etiqueta (disable()): La etiqueta tiene el estado DISABLED, aunque los usuarios pueden aplicarla a través de la API. Sin embargo, las etiquetas inhabilitadas no se muestran en la IU, a menos que se configuren para mostrarse. Si se da de baja la etiqueta, se incrementa su revisión.
  7. Habilita una etiqueta (enable()): La etiqueta se muestra en un estado PUBLISHED, y los usuarios pueden aplicarla. Publicar la etiqueta incrementa su revisión.
  8. Borra una etiqueta (delete()): La etiqueta tiene un estado de DELETED y no se puede aplicar. Con el tiempo, las etiquetas borradas se borran definitivamente.

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