Como remover metadados no Google Drive: guia completo e casos especiais

Informatec Digital » A Nuvem » Como excluir metadados no Google Drive: guia completo e casos especiais

Eliminar metadados no google drive

Se você se preocupa com as informações extras que acompanham seus arquivos na nuvem, provavelmente já se perguntou como limpar ou controlar esses dados invisíveis. No Google Drive, os metadados variam de tags e textos indexáveis ​​a miniaturas e propriedades dos arquivos. O segredo é entender o que pode ser removido, o que pode ser apenas atualizado e o que não pode ser alterado , para que você possa agir com precisão sem causar problemas.

Ao longo deste guia, reunimos em um só lugar informações que estão dispersas em várias documentações oficiais e artigos de ajuda do Google. Você aprenderá como remover metadados de tags de um arquivo, gerenciar texto indexável e miniaturas, e entender limites e exceções . Também esclarecemos cenários semelhantes (transferências do Cloud Storage e metadados de VMs no Compute Engine) para evitar confusão caso você esteja trabalhando com o Google Cloud.

O que são metadados no Drive e até onde esse termo vai?

No Google Drive, os metadados incluem informações como nome, tipo MIME, extensão inferida, rótulos, texto indexável e miniaturas associadas. Alguns elementos são editáveis ​​ou podem ser excluídos (por exemplo, rótulos), outros são atualizados indiretamente (texto indexável e miniaturas) e outros não podem ser excluídos porque fazem parte do sistema (como tamanho do arquivo ou datas internas de criação e atualização).

Você também verá referências a metadados em outros produtos do Google Cloud, como Cloud Storage ou Compute Engine. Você não deve confundir os metadados de uma VM ou objeto no Cloud Storage com os de um arquivo do Drive.; eles compartilham o conceito, mas sua gestão e limites são diferentes.
Gerenciar metadados em Dirigir

O que realmente pode ser removido no Drive

Do ponto de vista prático, o que geralmente se considera "remover metadados" no Drive é remover os rótulos aplicados a um arquivo. Os rótulos podem conter campos (texto, usuário etc.), e removê-los exclui as informações associadas a eles do arquivo . Essa exclusão é realizada por meio de uma API usando operações atômicas.

O texto indexável (contentHints.indexableText) não é simplesmente "excluído" com um botão; ele é sobrescrito ou deixado em branco quando você atualiza o recurso de arquivo . Ele foi projetado para melhorar a descoberta de tipos de arquivo que o Drive não indexa nativamente.

As miniaturas personalizadas são tratadas de forma semelhante: você pode carregar uma imagem de miniatura diferente ou parar de fornecer uma . Se o Drive puder gerar uma miniatura padrão, ele usará a sua própria; caso contrário, usará a que você fornecer.

Alguns metadados no Drive, como tamanho do arquivo e registros de data e hora internos, não podem ser excluídos. Essas propriedades do sistema são atualizadas pelo próprio serviço e não podem ser excluídas diretamente.

Remover rótulos de um arquivo no Google Drive

A API do Drive permite que você modifique ou remova rótulos usando o método files.modifyLabels. A solicitação inclui um objeto do tipo ModifyLabelsRequest com uma ou mais modificações que são aplicadas atomicamente. (se alguma não for válida, nada se aplica).

Para remover completamente uma tag de um arquivo, envie um LabelModification com o identificador de rótulo e a instrução de apagamento. Este processo remove todos os campos dessa tag no arquivo.Se você só precisa desabilitar um campo específico, você pode "desabilitar" esse campo sem remover a tag inteira.

Etapas conceituais para remover uma tag de um arquivo específico: 1) identifica o labelId do rótulo presente no arquivo (você pode listá-los com files.listLabels), 2) Envie a modificação com removeLabel ativado, 3) valida que a resposta inclui o estado final dos rótulos atualizados.

Texto indexável: controle, limites e boas práticas

Se o seu aplicativo salva tipos de arquivo que o Drive não indexa sozinho (desenhos, vídeos, atalhos, etc.), você pode aumentar a capacidade de pesquisa preenchendo contentHints.indexableText. Este texto é processado como HTML, indexado e pode aparecer em resumos de resultados. em mais superfícies de pesquisa.

Recomendações e limitações importantes: o tamanho máximo do texto indexável é de 128 KB ; capture termos e conceitos que realmente descrevam o conteúdo; não tente ordenar o texto por relevância, pois o indexador já prioriza; atualize o texto a cada salvamento ; evite "preencher" com palavras-chave irrelevantes (isso acaba frustrando os usuários e pode incentivar exclusões).

Lembre-se de que, como é tratado como HTML, o conteúdo do texto é indexado, não os atributos . Por exemplo, se sua string incluir tags com atributos, o texto visível será indexado, não os valores desses atributos.

Miniaturas: Carregar, Substituir e Recuperar

O Drive gera automaticamente miniaturas para Documentos, Planilhas, Apresentações e outros tipos. Se o seu tipo de arquivo não gerar uma miniatura padrão, você pode fornecer uma. configurando contentHints.thumbnail ao criar ou atualizar o arquivo.

Requisitos para miniaturas personalizadas: use PNG, GIF ou JPG; largura recomendada 1600 px (mínimo 220 px); tamanho máximo do arquivo 2 MB; fornece a imagem codificada em base64 com URL segura e o mimeType correcta. A miniatura deve ser atualizada a cada salvamento, porque ele é invalidado quando o conteúdo do arquivo é alterado (alterações de metadados por si só não o invalidam).

Para recuperar a miniatura, marque o campo thumbnailLink do recurso files. É um link de curta duração e só aparece se seu aplicativo puder acessar o conteúdo.Se o arquivo não for público, você precisará de credenciais para usar esse link.

Exemplos de consulta de metadados com miniaturas via REST:

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
GET https://www.googleapis.com/drive/v3/files?q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)

Nomes de arquivos e extensões: o que você deve saber

Ao inserir um arquivo via API, é recomendável especificar a extensão na propriedade name (por exemplo, cat.jpg). A unidade propagará essa extensão como fileExtension somente leitura em respostas subsequentes, e quando o usuário baixar o arquivo ou sincronizar com o cliente de desktop, o nome completo será gerado com base no título.

Se você não fornecer uma extensão, o Drive tentará determiná-la a partir do tipo MIME . Sempre que possível, especifique-a para evitar surpresas.

Não confunda remoção de metadados com exclusão de arquivos.

Remover metadados e excluir arquivos são ações diferentes. Se você é o proprietário de um arquivo e o envia para a Lixeira, você não está limpando os metadados; você está removendo o arquivo do seu disco . A opção de exclusão (quando você não é o proprietário) simplesmente o oculta de você, mas outras pessoas ainda poderão vê-lo.

Para enviar um arquivo para a lixeira na web: acesse drive.google.com, clique com o botão direito do mouse e selecione Mover para a lixeira . Se outra pessoa for a proprietária do arquivo, você verá a opção Remover. Para excluir o arquivo permanentemente, esvazie a lixeira. Nenhuma dessas etapas remove os metadados do arquivo armazenado: você exclui o arquivo ou gerencia seus metadados usando as opções explicadas.

Transferências e retenção de metadados do Cloud Storage (caso você mova dados)

Ao trabalhar com o Serviço de Transferência de Armazenamento para/do Armazenamento em Nuvem, existem regras sobre quais metadados são retidos e quais não são. Isso é fundamental se você usa o Drive com buckets ou migra dados entre nuvens.

Do Amazon S3 ou compatível para Cloud Storage

• Eles são conservados campos de metadados de chave fixa (por exemplo, Cache-Control, Content-Disposition, Content-Type).
• Metadados definidos pelo usuário são passados ​​para metadados personalizados no Cloud Storage (editável).
• El ETag É salvo como personalizado com a chave x-goog-source-etag.
• O tamanho do objeto é preservado como size.
• Listas de controle de acesso e tags de objeto do S3: não são preservados.
• Metadados de registro de data e hora S3: não são preservados. No armazenamento em nuvem, timeCreated y updated refletem o momento de criação/atualização no destino.
• Classe de armazenamento: configurável durante a transferência (por padrão, a do bucket de destino).

Do Microsoft Azure Blob ao armazenamento em nuvem

• Campos de metadados de chave corrigidos: eles são conservados.
• Metadados definidos pelo usuário: são salvos como personalizados no armazenamento em nuvem.
• ETag É preservado como x-goog-source-etag.
• Tamanho como size. Permissões POSIX do ADLS Gen2 e controle de acesso específico: não são preservados.
• Metadados do Azure Timestamp: não são preservados. timeCreated/updated são recalculados no destino.
• Classe de armazenamento: configurável como no caso do S3.

Entre os buckets do Cloud Storage

• Metadados de chave fixos e personalizados: eles são conservados.
• Geração de objetos: salvos como metadados personalizados x-goog-reserved-source-generation.
• Retenções: retenções temporárias são retidas por padrão; retenções baseadas em eventos não são. Cuidado com o LCA: Você pode mantê-los, mas evite criar objetos inacessíveis.
• Classe de armazenamento: manter, definir uma nova ou usar a do bucket de destino.
• Criptografia CMEK: opcional para manter; por padrão, o método do bucket de destino é usado.
• timeCreated pode ser mantido em customTime; updated n.
• Outros metadados não editáveis ​​(por exemplo, etag, componentCount): não.

Listas de URLs para armazenamento em nuvem

• Campos de metadados de chave corrigidos: editável no destino.
• Content-Length y MD5: não editável e são preservadas se a fonte as fornecer.
• Carimbos de data e hora da origem: não. Classe de armazenamento: configurável.

POSIX para armazenamento em nuvem (e vice-versa)

• mtime persistidos como metadados personalizados goog-reserved-file-mtime.
• O tamanho é preservado como size. UID, GID, MODE e links simbólicos: opcional via metadataOptions.
• De POSIX para POSIX, UID/GID/MODE podem ser preservados em arquivos e pastas; mtime Ele é salvo para arquivos (em pastas, é usado o horário de criação no destino).

Esses detalhes são importantes ao transferir dados entre serviços. Não espere que a exclusão de metadados em um sistema os faça desaparecer magicamente em outro ; respeite as regras de retenção de cada transferência.

Metadados do Compute Engine (VM): limites e exclusão, se você usar o Google Cloud

Embora não seja o Google Drive, muitas equipes acessam metadados de máquinas virtuais no Compute Engine. Para gerenciar isso, você precisa das permissões IAM apropriadas e conhecimento dos limites de tamanho e escopo.

Primeiro de tudo: instale o Google Cloud CLI e execute-o pela primeira vez com gcloud init (Se você usar um provedor de identidade externo, faça login federado.) Mantenha a CLI atualizada com gcloud components update e defina região e zona padrão para evitar erros de escopo.

Permissões típicas necessárias: se as VMs usarem contas de serviço, se precisa iam.serviceAccounts.actAs. Para metadados em nível de projeto: compute.projects.get y compute.projects.setCommonInstanceMetadata. Para metadados zonais: compute.instanceSettings.get y compute.instanceSettings.update. Para metadados em uma VM específica: compute.instances.get y compute.instances.setMetadata.

Limites principais: o conjunto de metadados por VM tem um máximo combinado de 512 KB; cada chave até 128 bytes e cada valor até 256 KB. As chaves SSH são armazenadas em ssh-keys; se você exceder o limite, É hora de limpar as chaves não utilizadasSe você colocar scripts de inicialização/desligamento como conteúdo direto, eles contarão para o limite; em vez disso, salve o script no Cloud Storage e fornece apenas o URL.

Maiúsculas/minúsculas: as teclas diferenciam maiúsculas de minúsculas; valores também, exceto para booleanos. Para metadados zonais: gerenciados apenas com gcloud ou REST; Você não pode duplicar chaves com o mesmo texto alterando a caixa (por exemplo, crie ZONAL-METADATA-KEY se zonal-metadata-key já existir); e você não pode definir valores zonais para ssh-keys.

Os valores booleanos aceitam equivalentes como VERDADEIRO/FALSO e alternativas como S/Sim/1 e N/Não/0, sem distinção entre letras maiúsculas e minúsculas.

Escopo e precedência: O mesmo nome de chave pode existir tanto no nível do projeto quanto no nível zonal, mas o valor zonal tem precedência em sua zona . Se você adicionar um valor zonal, ele será usado para as VMs nessa zona, mesmo que já exista um valor no nível do projeto; adicionar um valor de projeto não substitui os valores zonais existentes.

Operações comuns: Você pode configurar metadados de projeto (aplicáveis ​​a todas as VMs), metadados zonais (afetam todas as VMs em uma zona dentro desse projeto) e metadados de instância (apenas para uma VM). Para remover metadados, o gcloud ou a API REST permitem excluir metadados de projeto, zonais ou de instância, conforme necessário.

Usando REST localmente: Os exemplos da API REST usam as credenciais que você forneceu à CLI do gcloud. Autentique seu ambiente e reutilize essas credenciais para testar chamadas a partir da sua máquina.

Dicas práticas para melhor higiene de metadados no Drive

Se você deseja reduzir o espaço ocupado no Drive, concentre-se no que você pode controlar: rótulos (remova-os se não agregarem valor), texto indexável (ajuste ou limpe-o se não precisar dele) e miniaturas (substitua-as ou evite carregá-las) . As propriedades do sistema servem para auditoria, não para exclusão.

Quando um arquivo é compartilhado e você não é o proprietário, lembre-se de que removê-lo da sua visualização não exclui nada para os outros. Entre em contato com o proprietário se o objetivo for remover completamente o conteúdo ou os metadados associados.

Se você integrar o Drive com fluxos no Cloud Storage ou com máquinas virtuais, documente as expectativas. Muitos metadados mudam ou não são transferidos entre sistemas ; evite automações que dependam de carimbos de data/hora ou ACLs que não sejam preservadas.

Com essas diretrizes, você terá controle sobre o que realmente faz a diferença. Gerencie as tags com precisão, controle o que é indexável e decida quando e como usar miniaturas para encontrar um equilíbrio entre privacidade, capacidade de busca e experiência do usuário.