Visão geral dos rótulos

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 aplicar marcadores a arquivos e pastas, definir valores de campos de marcadores, ler marcadores e valores de campo em arquivos e pesquisar arquivos usando termos de metadados definidos pela taxonomia de marcadores personalizados.

Os marcadores do Drive podem auxiliar os processos comerciais anexando metadados a arquivos e pastas. Os usos comuns dos rótulos são:

  • Classificar o 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, você pode criar um marcador com selo (com valores de opção codificados por cores) chamado "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) em que os usuários não podem fazer o download de arquivos com o marcador "Sensibilidade" definido como "Confidencial".

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

Veja 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 do campo de marcadores para arquivos. Os marcadores são compostos por:

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

Um componente individual digitado e configurável de um rótulo. Um rótulo pode ter zero ou mais campos associados a ele. Os campos de seleção e de usuário poderão ser definidos com vários valores se estiverem configurados com ListOptions na API Google Drive Labels.

Tipo de campo
O tipo de dados do valor associado ao campo. Configurável como integer, dateString, text, user 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 marcadores configurados disponíveis para os usuários do aplicativo para arquivos do Drive. Legíveis e graváveis usando a API Drive Labels. Também conhecido como esquema de rótulos.

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.

Rascunho de revisão
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 da revisão de rascunho, sem afetar a revisão publicada. A possibilidade de ter rótulos de rascunho permite testar as atualizações antes da publicação.
Revisão publicada
O número de revisão da versão publicada de um marcador. O rótulo publicado é a instância do rótulo disponível para os usuários.