Visão geral dos rótulos

Os marcadores são metadados que você define para ajudar os usuários a organizar, encontrar e aplicar políticas aos arquivos no Google Drive. Com a API Drive, os desenvolvedores podem adicionar marcadores a arquivos e pastas, definir valores de campos de marcadores, ler marcadores e valores de campos em arquivos e pesquisar arquivos usando termos de metadados definidos pela taxonomia de marcadores personalizados.

Os marcadores do Drive podem oferecer suporte a processos de negócios anexando metadados a arquivos e pastas. Os usos comuns de rótulos são:

  • Classifique o conteúdo de acordo com uma estratégia de governança da informação: crie um marcador para identificar conteúdo ou dados sensíveis que exigem tratamento especial. Por exemplo, você pode criar um marcador com selo (um marcador com valores de opções codificados por cores) com o título "Sensibilidade" e os valores "Top Secret", "Confidencial" e "Público".

  • Aplicar a política a 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 marcadores para gerenciar uma política de prevenção contra perda de dados (DLP, na sigla em inglês), em que os usuários não podem fazer o download de arquivos com o marcador "Confidencialidade" definido como "Top Secret".

  • Selecionar e encontrar arquivos: crie marcadores para aumentar a capacidade de pesquisa do conteúdo da empresa, permitindo que as pessoas na sua organização encontrem itens com base em marcadores e campos. Por exemplo, aplique um rótulo "Status da assinatura" definido como "Aguardando assinatura" a todos os contratos que precisam ser assinados até uma data específica. A pesquisa do Drive pode retornar esses contratos quando alguém pesquisa "aguardando assinatura".

Confira abaixo uma lista de termos comuns usados pelos marcadores do Drive:

Rótulo

Metadados estruturados colocados em um arquivo do Drive. Os usuários do Drive podem atribuir marcadores e definir valores de campo de marcador para arquivos. Os rótulos são compostos por:

Nome do rótulo
: o nome do recurso do rótulo. O ID do rótulo faz parte do nome do rótulo. Dependendo da solicitação, o nome está no formato: 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. O ID faz parte do nome do rótulo, mas, ao contrário do nome, é consistente entre as revisões.
Campo

Um componente individual de um rótulo, tipado e configurável. Um marcador pode ter zero ou mais campos associados. Os campos de seleção e de usuário podem ser definidos com vários valores se o campo for configurado com ListOptions na API Google Drive Labels.

Tipo de campo
O tipo de dados do valor associado ao campo. Configurável como número inteiro, string de data, texto, usuário ou seleção. O tipo escolhido afeta os valores válidos aplicáveis aos itens do Drive e as opções de consulta de pesquisa disponíveis.
Taxonomia de rótulos

Os campos de rótulo configurados disponíveis para os usuários aplicarem aos arquivos do Drive. Pode ser lido e gravado pela API Drive Labels. Também conhecido como esquema de rótulo.

Revisão de rótulos

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

Revisão de rascunho
O número da revisão da instância de rascunho atual do rótulo. É possível fazer várias atualizações em um rótulo, cada uma incrementando o número de revisão do rascunho, sem afetar a revisão publicada. A capacidade de ter rascunhos de rótulos permite testar as atualizações antes da publicação.
Revisão publicada
O número da revisão da versão publicada de um rótulo. O rótulo publicado é a instância do rótulo disponível para os usuários.