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 o controle de versões:
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 podem ver o rótulo
Os usuários não podem aplicar o marcador a itens do Drive.
(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.
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.
(Opcional) Atualizar um marcador, campo ou opção (delta()): o marcador, o campo ou a opção são atualizados e armazenados 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 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 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.
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.
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.
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.
[null,null,["Última atualização 2025-08-29 UTC."],[],[],null,["# Label lifecycle\n\nLabels, fields, and choices go through specific states throughout their lives.\nAdditionally, labels might have different revisions. The following diagram shows\nthe label lifecycle, including revisioning:\n**Figure 3.** Lifecycle of a label\n\n1. **Create a label (`create()`)** ---The label is created and stored in a database as `revision_id=1`. The label has the state of `UNPUBLISHED_DRAFT`. In this state:\n - Users can't view the label\n - Users can't apply the label to Drive items.\n2. **(optional) Update a label, field, or choice (`delta()`)**--- Every update, even before it's published, is stored in a database, and the label's revision is incremented.\n3. **Publish a label (`publish()`)** ---The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its revision.\n4. **(optional) Update a label, field, or choice (`delta()`)** --- The label, field, or choice is updated and stored in a database as a draft label. The label has the state of `PUBLISHED` with `hasUnpublishedChanges=true` meaning there are draft changes, but they aren't available to users. Each update increments the label's revision.\n5. **(optional) Publish a label (`publish()`)** ---If available, the most-current draft is published. The label has the state of `PUBLISHED` and users can apply the label. Publishing the label increments its version.\n6. **Disable a label (`disable()`)** ---The label has the state of `DISABLED` though users can apply the label through the API. However, a disabled label isn't shown in a UI unless configured to be shown. Deprecating the label increments its revision.\n7. **Enable a label (`enable()`)** ---The label is returned to a `PUBLISHED` state and users can apply the label. Publishing the label increments its revision.\n8. **Delete a label (`delete()`)** ---The label has a state of `DELETED` and can't be applied. Deleted labels are eventually purged.\n\nIt's important to emphasize that every update to a label increments the label's\nrevision. And, if the label has already been published, publishing it again\nafter *n* updates means that its published revision number is revision + *n* + 1\nnumber of successive updates."]]
