Ciclo de vida de las etiquetas

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

Diagrama del ciclo de vida de las etiquetas
Figura 3: Ciclo de vida de una etiqueta
  1. Crea 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:
    • 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. Publica una etiqueta (publish()): La etiqueta tiene el estado PUBLISHED, y los usuarios pueden aplicarla. Publicar la etiqueta aumenta 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, y hasUnpublishedChanges=true 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. (Opcional) Publica una etiqueta (publish()): Si está disponible, se publicará el borrador más actual. La etiqueta tiene el estado PUBLISHED, y los usuarios pueden aplicarla. La publicación de la etiqueta aumenta 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, una etiqueta inhabilitada no se muestra en una IU, a menos que esté configurada para mostrarse. Dar de baja la etiqueta aumenta su revisión.
  7. Habilita una etiqueta (enable()): La etiqueta pasa a un estado PUBLISHED y los usuarios pueden aplicarla. Publicar la etiqueta aumenta su revisión.
  8. Borra una etiqueta (delete()): La etiqueta tiene un estado DELETED y no se puede aplicar. Las etiquetas borradas se borran definitivamente.

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