Ciclo de vida dos rótulos

Rótulos, campos e opções passam por estados específicos ao longo da vida. Além disso, os rótulos podem ter revisões diferentes. O diagrama a seguir mostra o ciclo de vida do rótulo, incluindo o controle de versões:

1. Criar um marcador (create()): o marcador é criado e armazenado em um banco de dados como revision_id=1. O rótulo tem o estado UNPUBLISHED_DRAFT. Nesse estado:
   • Os usuários não podem ver o rótulo
   • Os usuários não podem aplicar o marcador a itens do Drive.
2. (Opcional) Atualize um rótulo, campo ou opção (delta()): toda atualização, mesmo antes da publicação, é armazenada em um banco de dados, e a revisão do rótulo é incrementada.
3. Publicar um marcador (publish()): o marcador tem o estado PUBLISHED e os usuários podem aplicá-lo. Publicar o rótulo aumenta a revisão dele.
4. (Opcional) Atualizar um marcador, campo ou opção (delta()): o marcador, campo ou opção é atualizado e armazenado em um banco de dados como um marcador de rascunho. O rótulo tem o estado PUBLISHED com hasUnpublishedChanges=true, o que significa que há mudanças em rascunho, mas elas não estão disponíveis para os usuários. Cada atualização incrementa a revisão do rótulo.
5. (Opcional) Publicar um rótulo (publish()): se disponível, o rascunho mais recente será publicado. O marcador tem o estado PUBLISHED e pode ser aplicado pelos usuários. Publicar o rótulo incrementa a versão dele.
6. Desativar um rótulo (disable()): o rótulo tem o estado DISABLED, mas os usuários podem aplicá-lo pela API. No entanto, um rótulo desativado não aparece em uma interface, a menos que esteja configurado para isso. A descontinuação do rótulo incrementa a revisão.
7. Ativar um marcador (enable()): o marcador volta ao estado PUBLISHED e pode ser aplicado pelos usuários. Publicar o rótulo aumenta a revisão dele.
8. Excluir um marcador (delete()): o marcador tem o estado DELETED e não pode ser aplicado. Os marcadores excluídos são removidos permanentemente.

É importante enfatizar que cada atualização de um rótulo incrementa a revisão dele. Se o rótulo já tiver sido publicado, a publicação dele novamente após n atualizações significa que o número da revisão publicada é revisão + n + 1 número de atualizações sucessivas.