Visão geral dos rótulos

Os rótulos 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 rótulos, leiam marcadores e valores de campos em arquivos e pesquisem arquivos usando termos de metadados definidos pela taxonomia de rótulo personalizada.

Os rótulos no Drive são compatíveis com processos empresariais ao anexar metadados a arquivos e pastas. Os rótulos mais comuns são:

  • Classificar conteúdo para seguir uma estratégia de governança da informação: crie um rótulo para identificar dados confidenciais ou conteúdo que exija tratamento especial. Por exemplo, é possível criar um rótulo com selo, chamado "Sensibilidade", com os valores "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 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 rótulo "Confidencial" definido como "Secreto".

  • Selecionar e encontrar arquivos: crie marcadores para aumentar a possibilidade de pesquisa do conteúdo da sua empresa. Assim, as pessoas na sua organização poderão encontrar itens com base nos marcadores e nos campos. Por exemplo, aplique um rótulo "Status da assinatura" definido como "Aguardando assinatura" para todos os contratos que estejam aguardando 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 armazenados em um arquivo do Drive. Os usuários do Drive podem atribuir marcadores e definir valores de campo de marcador 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 do rótulo. Dependendo da solicitação, o nome tem o formato: labels/{id} ou labels/{id}@{revisionId}. Para mais informações, consulte Revisão do rótulo abaixo.
ID do rótulo
Um identificador exclusivo global 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 de tipo individual de um rótulo. Um rótulo pode ter zero ou mais campos associados a ele. Os campos de usuário e seleção poderão 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 número inteiro, dateString, 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 marcador configurados atualmente disponíveis para usuários dos aplicativos Drive para arquivos. Ele é legível e gravável pela 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 é 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 rascunho de revisão, sem afetar a revisão publicada. A possibilidade de ter rótulos de rascunho permite testar as atualizações de rótulos antes da publicação.
Revisão publicada
O número de revisão da versão publicada de um rótulo. O rótulo publicado é a instância do rótulo atualmente disponível para os usuários.

Próximas etapas