Ciclo de vida dos rótulos

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 do ciclo de vida do rótulo, incluindo a revisão:

Diagrama do ciclo de vida dos rótulos.
Figura 3. Ciclo de vida de um rótulo
  1. Criar um marcador (create()): o marcador é criado e armazenado em 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 marcador
    • Os usuários não podem aplicar o marcador aos itens do Drive.
  2. (opcional) Atualizar um marcador, um campo ou uma opção (delta()): todas as atualizações, mesmo antes de serem publicados, são armazenados em um banco de dados, e o identificador revisão é incrementada.
  3. Publicar um marcador (publish()): o marcador tem o estado PUBLISHED, e os usuários podem aplicar o marcador. A publicação do rótulo incrementa a revisão.
  4. (opcional) Atualizar um marcador, um campo ou uma opção (delta()): o marcador. ou a escolha é atualizada e armazenada em um banco de dados como um marcador de rascunho. A o rótulo tem o estado PUBLISHED com o significado de hasUnpublishedChanges=true. houver alterações no rascunho, mas elas não estarão disponíveis para os usuários. A cada atualização incrementa a revisão do rótulo.
  5. (opcional) Publicar um rótulo (publish()): se disponível, o rótulo mais atual rascunho for publicado. O marcador tem o estado PUBLISHED, e os usuários podem aplicar o marcador. A publicação do rótulo aumenta a versão.
  6. Desativar um marcador (disable()): o marcador tem o estado DISABLED. embora os usuários possam aplicar o rótulo pela API. No entanto, um marcador desativado não aparece em uma interface, a menos que seja configurado para ser mostrado. Descontinuação do rótulo aumenta sua revisão.
  7. Ativar um marcador (enable()): o marcador retorna para o estado PUBLISHED. e os usuários podem aplicar o marcador. A publicação do rótulo incrementa a revisão.
  8. Excluir um marcador (delete()): o marcador tem o estado DELETED e não podem ser aplicadas. Os rótulos excluídos serão removidos em algum momento.

É importante ressaltar que toda atualização de um rótulo incrementa revisão. E, se o marcador já tiver sido publicado, publicá-lo novamente após n atualizações significa que seu número de revisão publicada é a revisão + n + 1 o número de atualizações sucessivas.