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:
- Crea una etiqueta (
create()
): La etiqueta se crea y se almacena en una base de datos comorevision_id=1
. La etiqueta tiene el estadoUNPUBLISHED_DRAFT
. En este estado:- Los usuarios no pueden ver la etiqueta
- Los usuarios no pueden aplicar la etiqueta a los elementos de Drive.
- 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. - Publica una etiqueta (
publish()
): La etiqueta tiene el estadoPUBLISHED
, y los usuarios pueden aplicarla. Publicar la etiqueta aumenta su revisión. - 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 estadoPUBLISHED
, yhasUnpublishedChanges=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. - (Opcional) Publica una etiqueta (
publish()
): Si está disponible, se publicará el borrador más actual. La etiqueta tiene el estadoPUBLISHED
, y los usuarios pueden aplicarla. La publicación de la etiqueta aumenta su versión. - Inhabilita una etiqueta (
disable()
): La etiqueta tiene el estadoDISABLED
, 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. - Habilita una etiqueta (
enable()
): La etiqueta pasa a un estadoPUBLISHED
y los usuarios pueden aplicarla. Publicar la etiqueta aumenta su revisión. - Borra una etiqueta (
delete()
): La etiqueta tiene un estadoDELETED
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.