Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
Figura 3. Ciclo de vida de um rótulo
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.
(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 estado PUBLISHED e
os usuários podem aplicá-lo. A publicação do rótulo incrementa a revisão.
(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.
(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.
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.
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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-21 UTC."],[[["Labels, fields, and choices transition through various states such as UNPUBLISHED_DRAFT, PUBLISHED, DISABLED, and DELETED during their lifecycle."],["Labels are initially created in an UNPUBLISHED_DRAFT state and can't be viewed or applied until published."],["Every update to a label, including drafts and publishes, increments its revision number."],["Published labels can be disabled and re-enabled, each action impacting their state and revision."],["Deleting a label renders it unusable and eventually leads to its permanent removal."]]],["Labels have lifecycles involving creation, updates, publishing, disabling, enabling, and deletion. Upon creation, a label is an `UNPUBLISHED_DRAFT` and each update increments its revision number. Publishing transitions it to `PUBLISHED`, enabling user application. Updates to a published label create drafts (`hasUnpublishedChanges=true`) and also increment the revision. Disabling sets the state to `DISABLED`, while enabling returns it to `PUBLISHED`. Deletion changes the state to `DELETED`, and eventually the label is purged. Every label update increments the revision count.\n"]]