Rótulos, campos e escolhas 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 a revisão:
- Criar um rótulo (
create()
): o rótulo é criado e armazenado em um banco de dados comorevision_id=1
. O rótulo tem o estadoUNPUBLISHED_DRAFT
. Neste estado:- Os usuários não podem ver o marcador
- Os usuários não podem aplicar o marcador aos itens do Drive.
- (opcional) Atualizar um rótulo, campo ou opção (
delta()
): todas as atualizações, mesmo antes de serem publicadas, são armazenadas em um banco de dados, e a revisão do rótulo é incrementada. - Publicar um rótulo (
publish()
): o rótulo tem o estadoPUBLISHED
e os usuários podem aplicar o rótulo. A publicação do rótulo incrementa a revisão. - (opcional) Atualizar um rótulo, campo ou opção (
delta()
): o rótulo, o campo ou a opção é atualizado e armazenado em um banco de dados como um rótulo de rascunho. O rótulo tem o estadoPUBLISHED
comhasUnpublishedChanges=true
, o que significa que há mudanças no rascunho, mas elas não estão disponíveis para os usuários. Cada atualização incrementa a revisão do rótulo. - (opcional) Publicar um rótulo (
publish()
): se disponível, o rascunho mais atual é publicado. O marcador tem o estadoPUBLISHED
e os usuários podem aplicá-lo. A publicação do rótulo aumenta a versão. - Desativar um marcador (
disable()
): o marcador tem o estadoDISABLED
, mas os usuários podem aplicar o marcador pela API. No entanto, um rótulo desativado não é exibido em uma interface, a menos que seja configurado para ser mostrado. A descontinuação do rótulo incrementa a revisão dele. - Ativar um rótulo (
enable()
): o rótulo retorna a um estadoPUBLISHED
, e os usuários podem aplicá-lo. A publicação do rótulo incrementa a revisão. - Excluir um rótulo (
delete()
): o rótulo tem um estadoDELETED
e não pode ser aplicado. Os rótulos excluídos serão removidos em algum momento.
É importante enfatizar que cada atualização de um rótulo incrementa a revisão dele. E, se o rótulo já tiver sido publicado, publicá-lo novamente após n atualizações significa que o número de revisão publicado é a revisão + n + 1 número de atualizações sucessivas.