Visão geral da API Drive Labels

Marcadores são metadados que você define para ajudar os usuários a organizar, encontrar e aplicar políticas aos arquivos no Google Drive. A API Drive Label é uma API RESTful compatível com processos empresariais ao anexar metadados aos arquivos do Drive. Os usos comuns para essa API são:

  • Classificar conteúdo para seguir uma estratégia de governança da informação: crie um rótulo para identificar conteúdo ou dados confidenciais que exigem tratamento especial. Por exemplo, é possível criar um marcador com selo (um marcador com valores de opção codificados por cores) intitulado "Sensibilidade" com os valores "Confidencial", "Confidencial" e "Público".

  • Aplicar política aos itens no Drive: crie marcadores para gerenciar o conteúdo do Drive durante todo o ciclo de vida e garantir que ele siga as práticas de manutenção de registros da sua organização. Por exemplo, use rótulos para gerenciar uma política de perda de dados (DLP, na sigla em inglês) em que não é possível fazer o download em um computador de arquivos com um rótulo "Sensibilidade" definido como "Confidencial".

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

Veja 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 campos de marcadores para os arquivos. Os rótulos são compostos por:

Nome do rótulo
O nome do recurso do rótulo. Esse ID faz parte do nome do rótulo. Dependendo da solicitação, o nome tem a forma de: labels/{id} ou labels/{id}@{revisionId}. Para mais informações, consulte Revisão de rótulos abaixo.
ID do rótulo
Um identificador globalmente exclusivo para o rótulo. Ele compõe parte do nome do rótulo, mas, ao contrário do nome, ele é consistente entre as revisões.

Existem dois estilos de marcadores:

Marcador com selo

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

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

Rótulo padrão

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

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

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

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, poderá definir os campos de usuário e de seleção com vários valores. O tipo escolhido afeta os valores válidos aplicáveis aos itens do Drive e as opções de consulta de pesquisa disponíveis.
Escolha

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

Tipo de rótulo

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

Administrador

Para criar e editar marcadores de propriedade do administrador, você precisa ser um administrador da conta com o privilégio Gerenciar rótulos.

Os administradores podem compartilhar marcadores de administrador com qualquer usuário para permitir que ele visualize e aplique os marcadores a itens do Drive. Modificar ou ler valores de marcadores nos itens do Drive exige as seguintes permissões:

  • Modificação: para um usuário modificar os metadados de itens do Drive relacionados a um determinado marcador, ele precisa ter os níveis de permissão adequados:

    • Item do Google Drive: EDITOR
    • Rótulo: APPLIER
  • Leitura: para que um usuário leia ou pesquise os metadados de itens do Drive relacionados a um determinado marcador, ele precisa ter os níveis de permissão apropriados:

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

Os usuários que não são administradores podem criar marcadores compartilhados que outras pessoas podem aplicar aos itens do Drive. As equipes podem criar e organizar seus próprios rótulos para uso dentro da equipe sem exigir um administrador.

Taxonomia de rótulos

Os campos de marcadores configurados atualmente disponíveis para os usuários para aplicação em arquivos do Drive. Também conhecido como esquema de rótulos.

Exemplo de taxonomias de rótulo:

  • Sensibilidade: vermelho, laranja, amarelo, verde
  • Status: Não iniciado, Rascunho, Em análise, 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 avança no ciclo de vida, a revisão dele é incrementada. 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 de rascunho
O número de revisão da instância de rascunho atual do marcador. É possível fazer várias atualizações em um rótulo, cada uma incrementando o número de revisão de rascunho, sem afetar a revisão publicada. A possibilidade de ter rótulos de rascunho permite testar as atualizações deles antes da publicação.
Revisão publicada
O número de revisão da versão publicada de um marcador. O marcador publicado é a instância do marcador atualmente disponível para os usuários.