Criar e publicar um rótulo

Esta página descreve como criar e publicar um rótulo.

Criar um marcador

Para criar um rótulo, use o método create na coleção labels. Os rótulos podem opcionalmente conter um ou mais Fields.

Você também precisa especificar:

• Uma LabelType.

• Um rótulo title pelo método property.

• useAdminAccess é true para usar as credenciais de administrador do usuário. O servidor verifica se o usuário é um administrador com o privilégio "Gerenciar marcadores" antes de permitir o acesso.

Este exemplo cria um rótulo padrão de administrador com um título especificado e um SelectionOptions Field com 2 Choices.

PythonNode.js

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

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

O rótulo é criado no UNPUBLISHED_DRAFT State. Ele precisa ser PUBLISHED para uso em arquivos e ficar visível para os usuários. Para mais informações, consulte Ciclo de vida do rótulo.

Limites de rótulos

Os limites a seguir se aplicam ao criar e aplicar rótulos:

• Rótulos padrão: 150
• Campos por rótulo: 10
• Rótulos aplicados pelo usuário por arquivo: 5

Como trabalhar com campos em marcadores

Field Type	O que os usuários podem fazer	Considerações e limites de formato
SelectionOptions	Selecionar uma ou mais opções em uma lista	O número máximo de opções com suporte é 200 O número máximo de seleções para um arquivo é 10, conforme configurado em ListOptions
IntegerOptions	Insira um valor numérico	Apenas números inteiros são aceitos
DateOptions	Selecionar uma data	(Opcional) Date format pode ser definido como "Longo: DD do mês, AAAA" ou "Curto: DD/MM/AA"
TextOptions	Digitar em uma caixa de texto	O número máximo de caracteres permitido é 100
UserOptions	Selecione um ou mais usuários nos contatos do Google Workspace.	O número máximo de entradas de usuários para um arquivo é 10, conforme configurado em ListOptions.

Publicar um marcador

A API Labels permite que você publique um marcador de rascunho quando ele estiver concluído.

Para publicar um marcador, use o método publish e especifique:

• 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 com o privilégio "Gerenciar marcadores" antes de permitir o acesso.

Neste exemplo, usamos ID para identificar e publicar o rótulo correto.

PythonNode.js

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

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

Depois que o rótulo é publicado, ele é movido para o PUBLISHED State, e o ID de revisão do rótulo é incrementado. O marcador fica visível para os usuários e pode ser aplicado aos arquivos. Para mais informações, consulte o Ciclo de vida do rótulo.

Restrições ao publicar rótulos

• Depois de publicado, um rótulo não pode voltar ao estado de rascunho original. Para mais informações, consulte Ciclo de vida do rótulo.

• A publicação de um rótulo cria uma revisão recém-publicada. Todas as revisões de rascunho anteriores são excluídas. As revisões publicadas anteriormente são mantidas, mas estão sujeitas à exclusão automática, conforme necessário.

• Depois de publicadas, algumas mudanças não são mais permitidas. Em geral, isso significa que qualquer mudança que invalide ou acione novas restrições nos metadados existentes relacionados ao rótulo é rejeitada. Por exemplo, as seguintes mudanças em um rótulo não são permitidas após a publicação:

  • O rótulo é excluído diretamente. Ela precisa ser desativada primeiro e depois excluída.
  • O Field.FieldType foi alterado.
  • As atualizações nas opções de validação de campo rejeitam algo que foi aceito anteriormente.
  • Uma redução no número máximo de entradas.