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 a revisão:

Diagrama do ciclo de vida dos marcadores.
Figura 3. Ciclo de vida de um rótulo
  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 conseguem visualizar o rótulo
    • Os usuários não podem aplicar o marcador a itens do Drive.
  2. (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.
  3. Publicar um rótulo (publish()): o rótulo tem o estado PUBLISHED e os usuários podem aplicá-lo. A publicação do rótulo incrementa a revisão.
  4. (opcional) Atualizar um rótulo, campo ou escolha (delta()): o rótulo, o campo ou a escolha é atualizado e armazenado em um banco de dados como um rascunho. O rótulo tem o estado de PUBLISHED com hasUnpublishedChanges=true, o que significa que há mudanças de 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 é publicado. O marcador tem o estado PUBLISHED e os usuários podem aplicá-lo. A publicação do 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 aplicar o rótulo pela API. No entanto, um rótulo desativado não é mostrado em uma interface, a menos que seja configurado para aparecer. A descontinuação do rótulo aumenta a revisão.
  7. Ativar um marcador (enable()): o marcador é retornado ao estado PUBLISHED e os usuários podem aplicá-lo. A publicação do rótulo incrementa a revisão.
  8. Excluir um identificador (delete()): o identificador tem um estado de DELETED e não pode ser aplicado. Os rótulos excluídos são limpos.

É importante enfatizar que cada atualização de um rótulo incrementa a revisão dele. 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.