Desativar, ativar e excluir um rótulo

Esta página descreve como realizar estas tarefas envolvendo rótulos:

• Desativar um rótulo
• Ativar um marcador
• Excluir etiqueta

Desativar um rótulo

A desativação de um identificador resulta em uma nova revisão publicada desativada com base na revisão publicada atual. Se houver uma revisão de rascunho, uma nova revisão de rascunho desativada será criada com base na revisão de rascunho mais recente. As revisões de rascunho mais antigas são excluídas. Para mais informações, consulte Ciclo de vida do rótulo.

Depois de desativado, os usuários ainda podem aplicar esse rótulo pela API. O rótulo ainda aparece nos itens em que já foi aplicado e nos resultados da pesquisa. Um rótulo desativado pode ser excluído.

Para desativar um rótulo publicado, use o método disable na coleção labels.

Você também precisa especificar:

• Um recurso de rótulo que representa todos os rótulos. Ele contém um recurso Name e ID, que é um identificador globalmente exclusivo do rótulo.

• useAdminAccess é true para usar as credenciais de administrador do usuário. O servidor verifica se o usuário é um administrador do marcador antes de permitir o acesso.

Este exemplo usa ID para desativar o rótulo correto.

Python

service.labels().disable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.disable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

O rótulo tem o State de DISABLED e o ID de revisão do rótulo é incrementado. 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 a propriedade showInApply do método disabledPolicy esteja configurada.

Ativar um marcador

A ativação de um rótulo desativado restaura o estado publicado dele. Isso resulta em uma nova revisão publicada com base na revisão publicada desativada atual. Se houver uma revisão de rascunho desativada, uma nova revisão será criada com base nesse rascunho e ativada. Para mais informações, consulte Ciclo de vida do rótulo.

Para ativar um rótulo desativado, use o método enable.

Você também precisa especificar:

• Um recurso de rótulo que representa todos os rótulos. Ele contém um recurso Name e ID, que é um identificador globalmente exclusivo do rótulo.

• useAdminAccess é true para usar as credenciais de administrador do usuário. O servidor verifica se o usuário é um administrador do marcador antes de permitir o acesso.

Neste exemplo, usamos ID para ativar o rótulo correto.

Python

service.labels().enable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.enable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

O rótulo tem o State de PUBLISHED e o ID de revisão do rótulo é incrementado. Os usuários podem conferir e aplicar o marcador aos arquivos pela API.

Excluir etiqueta

Somente os rascunhos e rótulos desativados podem ser excluídos. Quando um marcador é excluído, todas as instâncias em que ele foi aplicado antes, inclusive os valores de campo correspondentes digitados pelos usuários, são excluídos e removidos dos arquivos do Drive.

Para excluir um marcador, primeiro desative-o e depois use o método delete.

Você também precisa especificar:

• Um recurso de rótulo que representa todos os rótulos. Ele contém um recurso Name e ID, que é um identificador globalmente exclusivo do rótulo.

• useAdminAccess é true para usar as credenciais de administrador do usuário. O servidor verifica se o usuário é um administrador do marcador antes de permitir o acesso.

Este exemplo usa ID para excluir o rótulo correto.

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

service.labels.delete({
  'name': 'labels/ID',
  'use_admin_access': true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

O rótulo tem o State de DELETED e o ID de revisão do rótulo é incrementado. O rótulo não pode ser aplicado, e os rótulos excluídos são limpos. Para mais informações, consulte Ciclo de vida do rótulo.