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 campos em arquivos e pesquisar arquivos usando termos de metadados definidos pela taxonomia de marcadores personalizados.

Os marcadores do Drive podem auxiliar processos comerciais 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 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 os usuários não podem fazer o download de arquivos com um marcador "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, aplique um rótulo "Status da assinatura" definido como "Aguardando assinatura" a todos os contratos que aguardam a assinatura até uma data específica. A pesquisa do Drive pode retornar esses contratos quando alguém pesquisa "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 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 dele. 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. 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 configurável de um rótulo. Um rótulo pode ter zero ou mais campos associados a ele. Os campos de seleção e 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, 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 marcadores configurados disponíveis para os usuários aplicarem aos arquivos do Drive. Legível e gravável 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.

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 disponível para os usuários.