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

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

  • Classificar conteúdo para seguir uma estratégia de governança da informação: crie um marcador para identificar conteúdo sensível ou dados que exijam 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 "Ultrassecreto", "Confidencial" e "Público".

  • Aplicar 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) em que os usuários não podem baixar arquivos com um marcador "Confidencialidade" definido como "Ultrassecreto".

  • Selecionar e encontrar arquivos: crie marcadores para aumentar a capacidade de pesquisa do conteúdo da sua empresa. Assim, as pessoas na organização podem encontrar itens com base em marcadores e campos. Por exemplo, aplique um conjunto de rótulos "Status da assinatura" a "Aguardando assinatura" em 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 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 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, ele é consistente entre as revisões.
Campo

Um componente individual tipado e definível de um rótulo. 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 estiver configurado 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 selection. 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 marcador 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 da revisão do rascunho, sem afetar a revisão publicada. Com os marcadores de rascunho, você pode testar as atualizações antes de publicar.
Revisão publicada
O número da revisão da versão publicada de um rótulo. O marcador publicado é a instância do marcador disponível para os usuários.