Visão geral da API Drive Labels

Rótulos são metadados que você define para ajudar os usuários a organizar, encontrar e aplicar política a arquivos no Google Drive. A API Drive Labels é uma API RESTful oferece suporte a processos empresariais anexando metadados a seu Google Drive . Os usos comuns dessa API são:

  • Classifique o conteúdo para seguir uma estratégia de governança da informação: crie um rótulo para identificar conteúdo ou dados sensíveis que exigem tratamento especial. Por exemplo, você pode criar um marcador com selo (um marcador com selo valores de opção) intituladas "Sensibilidade" com os valores de "Ultrassecreto", "Confidencial", e "Público".

  • Aplicar política a itens no Drive: crie marcadores para gerenciar. Impulsionar o conteúdo ao longo do ciclo de vida e garantir que ele esteja de acordo às práticas de manutenção de registros da organização. Por exemplo, use rótulos para uma política de perda de dados (DLP) em que os arquivos com o nível de conjunto de rótulos para "Ultrassecreto" não podem ser baixados para um computador.

  • Selecionar e encontrar arquivos: crie marcadores para aumentar o potencial de pesquisa. conteúdo da empresa permitindo que as pessoas da organização encontrem itens com base os rótulos e os campos deles. Por exemplo, alguém na sua organização poderia usar As opções de pesquisa do Drive para encontrar todos os contratos aguardando assinatura por uma data específica.

Confira abaixo uma lista de termos comuns usados na API Drive Labels:

Rótulo

Metadados estruturados colocados em um arquivo do Drive. Os usuários do Drive podem atribuir marcadores e definir valores de campo para . Eles são compostos de:

Nome do rótulo
O nome de recurso do rótulo. O ID do rótulo é parte do Nome do marcador. Dependendo da solicitação, o nome terá um dos seguintes formatos: labels/{id} ou labels/{id}@{revisionId}. Para mais informações, consulte Revisão do rótulo abaixo.
ID do rótulo
Um identificador globalmente exclusivo do rótulo. O ID compõe parte do nome do rótulo, mas, diferentemente do nome, é consistente entre revisões.

Há dois estilos de rótulos:

Marcador com selo

Um rótulo com SelectionOptions tipo de campo contendo opções que podem ser codificadas por cores para indicar importância. Isso é feito definindo badgeConfig através do Properties de um Choice.

O Drive mostra a cor da opção escolhida em cada arquivo para que os usuários entender claramente o status, a classificação e assim por diante do arquivo. Por exemplo, "Confidencial" da opção "Sensibilidade" marcador com selo podem aparecer em vermelho. Você só pode ter um marcador com selo por vez.

Marcador padrão

Um rótulo que contém zero ou mais tipos de campo. Um marcador padrão pode têm um título de rótulo, como "Projeto lunar", e indicar todos os arquivos relacionadas ao projeto. Um marcador padrão também pode ter várias campos estruturados. Por exemplo, um marcador com o título "Contrato" pode contêm os campos "Company", "Data de vencimento", "Status", e "Signatários". Cada campo é de um tipo específico (texto, data, ou usuário).

Diagrama de rótulos com selo.
Figura 1. Marcador com selo
Diagrama de rótulos padrão.
Figura 2. marcador padrão
Campo

Um componente individual digitado e configurável de um rótulo. Um rótulo pode ter zero ou mais campos associados a ela.

Tipo de campo
O tipo de dados do valor associado ao campo. Configurável como texto, número inteiro, data, usuário ou seleção. Se você configurar o campo com ListOptions, é possível definir o usuário e os campos de seleção com várias valores. O tipo escolhido afeta os valores válidos aplicáveis ao Itens do Drive e as opções de consulta de pesquisa disponíveis.
Escolha

Uma das várias opções que um usuário pode escolher em uma SelectionOptions. .

Tipo de rótulo

Todos os rótulos incluem um LabelType. Há dois tipos de rótulos:

Administrador

Para criar e editar marcadores de propriedade do administrador, você precisa ser uma conta com a conta de administrador do Gerenciar marcadores privilégio mínimo.

Os administradores podem compartilhar marcadores de administrador com qualquer usuário para conceder a ele visualizar e aplicá-las aos itens do Google Drive. Modificar ou ler os valores dos marcadores nos itens do Drive exigem as seguintes permissões:

  • "Modificando": para um usuário modificar os metadados de um item do Drive relacionados a uma determinado rótulo, o usuário deve ter os níveis de permissão adequados:

    • Item do Google Drive: EDITOR
    • Rótulo: APPLIER

  • Leitura: para um usuário ler ou pesquisar os metadados do item do Drive. relacionadas a um determinado rótulo, o usuário deve ter as credenciais níveis de permissão:

    • Item do Google Drive: READER
    • Rótulo: READER
Shared

Usuários que não são administradores podem criar marcadores compartilhados que outras pessoas podem aplicar aos itens do Google Drive. As equipes podem criar e organizar os próprios marcadores para uso com a equipe sem precisar de um administrador.

Taxonomia dos rótulos

Os campos de marcadores configurados e disponíveis aos usuários para que o app Arquivos do Google Drive. Também conhecido como esquema de rótulos.

Exemplos de taxonomias de rótulos:

  • Sensibilidade: vermelho, laranja, amarelo, verde
  • Status: não iniciado, rascunho, em análise ou final
  • Tipo de conteúdo: contrato, documento de design, modelo
  • Departamento: marketing, finanças, recursos humanos, vendas
Ciclo de vida do rótulo

Os rótulos passam por um ciclo de vida em que são criados, publicados, atualizados e assim por diante. À medida que um rótulo passa pelo ciclo de vida, a revisão de rótulo dele é incrementado. Para mais informações, consulte Ciclo de vida do rótulo.

Revisão do rótulo

Uma instância do rótulo. Sempre que um rótulo é criado, atualizado, publicado ou descontinuado, a revisão do rótulo aumenta.

Revisão do rascunho
O número da revisão da instância de rascunho atual do rótulo. Você pode faz várias atualizações em um marcador, cada uma incrementando a revisão de rascunho sem afetar a revisão publicada. A capacidade de ter os marcadores de rascunho permitem testar as atualizações deles antes da publicação.
Revisão publicada
O número da revisão da versão publicada de um rótulo. O modelo "label" é a instância do rótulo disponível para os usuários no momento.