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. A API Drive permite que os desenvolvedores apliquem marcadores a arquivos e pastas, definam valores de campos de marcadores, leiam marcadores e valores de campos em arquivos e pesquisem 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 marcadores são:

  • Classificar o conteúdo para seguir 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ção codificados por cores) chamado "Sensibilidade" com os valores "Altamente confidencial", "Confidencial" e "Público".

  • Aplicar políticas 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) em que os usuários não podem fazer o download de arquivos com um marcador "Sensibilidade" definido como "Altamente confidencial".

  • Organizar 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 em marcadores e campos. Por exemplo, aplique um marcador "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 pesquisar "aguardando assinatura".

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

Marcador

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

Nome do marcador
O nome do recurso do marcador. O ID do marcador faz parte do nome do marcador. Dependendo da solicitação, o nome está no formato: labels/{id} ou labels/{id}@{revisionId}. Para mais informações, consulte Revisão do marcador abaixo.
ID do marcador
Um identificador globalmente exclusivo para o marcador. O ID faz parte do nome do rótulo, mas, ao contrário do nome, ele é consistente entre as revisões.
Campo

Um componente individual digitado e configurável de um marcador. Um marcador pode ter zero ou mais campos associados a ele. 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 do Google Drive Labels.

Tipo de campo
O tipo de dados do valor associado ao campo. Pode ser configurado 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 marcadores

Os campos de marcadores configurados disponíveis para os usuários aplicarem aos arquivos do Drive. Podem ser lidos e gravados pela API Drive Labels. Também conhecido como esquema de marcador.

Revisão do marcador

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

Revisão de rascunho
O número de revisão da instância de rascunho atual do rótulo. Você pode fazer várias atualizações em um marcador, cada uma incrementando o número de revisão de rascunho, sem afetar a revisão publicada. A capacidade de ter marcadores de rascunho permite testar atualizações de marcadores 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 disponível para os usuários.