Como remover metadados no Google Drive

Você quer controlar os metadados dos seus arquivos em Google drive e não sabe por onde começar? Aqui explicamos, em detalhes, Como remover metadados no Google Drive de forma eficaz e segura (os metadados dos arquivos enviados). Também informamos quais limites o Google impõe em relação a nomes, tamanhos e permissões de arquivos.

Este guia lhe dará uma compreensão completa e realista do que pode (e não pode) ser "excluído" quando se trata de metadados no Google Drive.

O que pode ser alterado ou “excluído” no Drive

Estes são os metadados que podem ser removidos de arquivos enviados para o Google Drive:

Nome e extensão: Ao criar um arquivo via API, é recomendável especificar a extensão no campo de nome, por exemplo, "cat.jpg". O Drive pode inferir a extensão a partir do tipo MIME se você não a especificar, mas é melhor defini-la você mesmo. Em respostas subsequentes, uma extensão de arquivo somente leitura pode aparecer com a extensão preenchida a partir do nome. Se um usuário baixar o arquivo, o Drive compila o nome final a partir do título (e sua extensão).

• Texto indexável (contentHints.indexableText): O Drive indexa documentos e tipos comuns (PDFs, imagens com OCR etc.) por padrão. Se o seu aplicativo salva outros formatos (desenhos, vídeos, atalhos), você pode fornecer texto indexável para melhorar a pesquisa. Esse texto é processado como HTML: se você passar uma string contendo tags, o conteúdo textual será indexado, não os atributos das tags. Há um limite de tamanho de 128 KB para contentHints.indexableText, e é recomendável atualizá-lo a cada salvamento e mantê-lo relevante para o arquivo.
• Miniaturas (contentHints.thumbnail): O Drive gera miniaturas para muitos tipos, mas para formatos que não as geram automaticamente, você pode enviar as suas próprias ao criar ou atualizar o arquivo. Você deve definir a imagem como base64 segura para URL e o mimeType correspondente. Regras principais: Os formatos suportados são PNG, GIF ou JPG; a largura recomendada é 1600px (mínimo 220px) e o tamanho máximo é 2MB. As miniaturas são invalidadas quando o conteúdo do arquivo é alterado; alterações nos metadados não.
• Acesso às miniaturas: O campo ThumbnailLink retorna um URL curto, acessível somente se o aplicativo tiver permissão para ler o arquivo (se não for público, você precisará solicitá-lo com credenciais). Você pode consultá-lo para um arquivo específico ou para uma lista filtrada por tipo.
• Etiquetas: O Drive permite associar rótulos a arquivos. Para localizá-los, você pode usar files.listLabels e, para modificá-los, você deve referenciar o labelId e o fileId correspondentes. Esse mecanismo é útil para categorizar e, se necessário, "limpar" classificações indesejadas sem alterar o conteúdo.

Excluir metadados no Google Drive: metadados “ocultos” do próprio arquivo

Não existe um botão mágico para remover metadados no Google Drive (como EXIF ​​em fotos ou dados incorporados em PDFs). O Drive gerencia seus próprios metadados, mas os metadados dentro do arquivo dependem da ferramenta que o criou.

A prática recomendada é limpe o arquivo antes de enviá-lo para o Drive, Usando ferramentas do sistema ou aplicativos especializados que removem dados EXIF ​​de imagens ou propriedades de documentos. Dessa forma, o conteúdo que você salva no Drive chega "limpo".

Se você já tiver arquivos enviados com metadados incorporados, em vez de remover metadados no Google Drive, é mais conveniente baixar, limpar e reenviar, Substituindo o original, se aplicável. Com PDFs ou imagens, isso é comum quando você deseja proteger autoria, localização ou histórico de edição.

Para a parte específica do Drive, foco no ajuste de nome, rótulos e dicas de conteúdo (indexableText/thumbnail), que estão sob seu controle. Se você também gerenciar permissões de acesso, também reduzirá a exposição de metadados visíveis (por exemplo, links de miniaturas acessíveis a quem tem direitos de leitura).

Não esqueça isso Alterar apenas os metadados do Drive não remove o EXIF ​​nem as propriedades internas. Portanto, sua estratégia deve combinar a pré-limpeza do arquivo com o gerenciamento detalhado de metadados que o Drive permite que você toque.

Metadados comumente confundidos no Google Cloud: VMs, gcloud e limites

Se você trabalha com o Google Cloud, verá muitos guias sobre “metadados” que na verdade se referem ao Compute Engine ou ao Cloud Storage, não ao Drive. Mesmo assim, você vai querer saber esses pontos para não confundi-los na hora de pesquisar.

Configuração básica do gcloud CLI

Após instalar o Google Cloud CLI, inicialize com:

gcloud init

É importante certificar-se de que você tenha a versão mais recente com:

gcloud components update

Se você usar um provedor de identidade externo, Faça login com sua identidade federada antes de trabalhar com o gcloud, Especialmente se você for autenticar para fazer chamadas REST do seu ambiente local. Os exemplos de API REST podem usar as credenciais que você configurou no gcloud.

VMs

Permissões e funções (Compute Engine): Para adicionar, atualizar ou excluir metadados personalizados em VMs, você precisa das permissões de IAM apropriadas. Exemplos comuns incluem:

• Se suas VMs usam contas de serviço: permissão iam.serviceAccounts.actAs na conta de serviço ou projeto.
• Metadados do projeto: compute.projects.get y compute.projects.setCommonInstanceMetadata.
• Metadados zonais: compute.instanceSettings.get y compute.instanceSettings.update para a área relevante.
• Metadados da instância: compute.instances.get y compute.instances.setMetadata.

Limitações

Estas são as principais limitações que encontramos ao tentar remover metadados no Google Drive:

• Limitações de tamanho (Compute Engine): O total combinado de entradas de metadados é limitado a 512 KB. Cada chave tem um limite de 128 bytes e cada valor tem um limite de 256 KB. Se, por exemplo, você usar a chave ssh-keys e exceder o limite de 256 KB, não poderá adicionar mais chaves até que a limpeza seja concluída.
• Maiúsculas e Minúsculas: As chaves diferenciam maiúsculas de minúsculas; os valores também, exceto os booleanos. Em zonal, não é possível criar duas chaves que diferem apenas em maiúsculas e minúsculas (zonal-metadata-key vs. ZONAL-METADATA-KEY).
• Metadados zonais: são definidos ou removidos usando gcloud ou REST. Não é possível definir valores zonais para chaves SSH (ssh-keys). No diretório lógico project/, se houver valores de nível de projeto e zonais para a mesma chave, o valor zonal terá precedência em sua zona.
• Valores booleanos suportados: Além de VERDADEIRO/FALSO, você pode usar S/Sim/1 e N/Não/0 (sem distinção de maiúsculas e minúsculas).
• Escopos de configuração (Compute Engine):
  • Projeto: metadados comuns a todas as VMs no projeto.
  • Zonal: entradas que afetam todas as VMs em uma zona específica e podem substituir o valor do projeto.
  • Exemplo: metadados para uma VM específica (sendo criada ou já existente).

Miniaturas, indexação e recuperação de metadados no Drive (REST e práticas recomendadas)

Vamos agora analisar a função das miniaturas na remoção de metadados no Google Drive. E também a melhor maneira de recuperá-los:

• Autenticação para REST local: Se você estiver testando exemplos REST na sua máquina, use as credenciais configuradas com o gcloud. Dessa forma, suas chamadas à API do Drive respeitarão a identidade e as permissões que você já definiu.
• Upload de miniatura personalizada: Defina contentHints.thumbnail com dois campos: a imagem em base64 com URL segura e o mimeType correto. Se o Drive puder gerar uma miniatura automaticamente, ele usará a sua própria miniatura e ignorará a sua. Caso contrário, usará a que você fornecer.

Regras principais para miniaturas no Drive:

• Formatos: PNG, GIF ou JPG.
• Largura recomendada: 1600 px (mínimo 220 px).
• Tamanho máximo: 2 MB.
• Atualize a miniatura a cada salvamento, se ela ainda for relevante.

Importante sobre invalidação: As miniaturas são invalidadas quando o conteúdo do arquivo é alterado; alterações nos metadados, não. Se você alterar apenas as tags ou o nome, não espere uma nova miniatura, a menos que modifique o arquivo.

Texto indexável

Não tente "enganar" a busca com chavões. Capture conceitos e termos que um usuário razoavelmente procuraria naquele arquivo e verifique o limite de 128 KB. Atualize-o sempre que o conteúdo mudar substancialmente.

Aplique nomes e extensões consistentesSempre que possível, inclua a extensão no nome ao fazer o upload; se estiver ausente, o Drive tentará deduzi-la por MIME. Manter os nomes claros evitará ambiguidades e facilitará as pesquisas por extensão.

Tags na unidade

Para modificar rótulos, anote os identificadores necessários. Você precisará do labelId do rótulo e do fileId do arquivo. Você pode listá-los primeiro com files.listLabels e depois aplicar as alterações correspondentes ao arquivo de destino.

// Al modificar etiquetas de un archivo en Drive:
// - labelId: identificador de la etiqueta a cambiar
// - fileId: identificador del archivo al que aplicas la etiqueta
// Usa files.listLabels para localizarlas antes de actualizar.

Lembra que, Embora o Drive seja o foco, muitos desenvolvimentos combinam o Drive com o Cloud Storage ou outros serviços, Portanto, você verá exemplos de armazenamento para inspecionar atributos de objetos.

// Ejemplo en Go para obtener atributos de un objeto en Cloud Storage (no Drive)
// e imprimir metadatos como ContentType, CacheControl, MD5, etc.
// Útil si tu flujo sube primero a Storage y luego a Drive.
import (
  "context"
  "fmt"
  "io"
  "time"
  "cloud.google.com/go/storage"
)

func getMetadata(w io.Writer, bucket, object string) (*storage.ObjectAttrs, error) {
  ctx := context.Background()
  client, err := storage.NewClient(ctx)
  if err != nil { return nil, fmt.Errorf("storage.NewClient: %w", err) }
  defer client.Close()

  ctx, cancel := context.WithTimeout(ctx, 10*time.Second)
  defer cancel()

  o := client.Bucket(bucket).Object(object)
  attrs, err := o.Attrs(ctx)
  if err != nil { return nil, fmt.Errorf("Object(%q).Attrs: %w", object, err) }

  fmt.Fprintf(w, "Bucket: %v\n", attrs.Bucket)
  fmt.Fprintf(w, "CacheControl: %v\n", attrs.CacheControl)
  fmt.Fprintf(w, "ContentDisposition: %v\n", attrs.ContentDisposition)
  fmt.Fprintf(w, "ContentEncoding: %v\n", attrs.ContentEncoding)
  fmt.Fprintf(w, "ContentLanguage: %v\n", attrs.ContentLanguage)
  fmt.Fprintf(w, "ContentType: %v\n", attrs.ContentType)
  fmt.Fprintf(w, "Crc32c: %v\n", attrs.CRC32C)
  fmt.Fprintf(w, "Generation: %v\n", attrs.Generation)
  fmt.Fprintf(w, "KmsKeyName: %v\n", attrs.KMSKeyName)
  fmt.Fprintf(w, "Md5Hash: %v\n", attrs.MD5)
  fmt.Fprintf(w, "MediaLink: %v\n", attrs.MediaLink)
  fmt.Fprintf(w, "Metageneration: %v\n", attrs.Metageneration)
  fmt.Fprintf(w, "Name: %v\n", attrs.Name)
  fmt.Fprintf(w, "Size: %v\n", attrs.Size)
  fmt.Fprintf(w, "StorageClass: %v\n", attrs.StorageClass)
  fmt.Fprintf(w, "TimeCreated: %v\n", attrs.Created)
  fmt.Fprintf(w, "Updated: %v\n", attrs.Updated)
  fmt.Fprintf(w, "Event-based hold enabled? %t\n", attrs.EventBasedHold)
  fmt.Fprintf(w, "Temporary hold enabled? %t\n", attrs.TemporaryHold)
  fmt.Fprintf(w, "Retention expiration time %v\n", attrs.RetentionExpirationTime)
  fmt.Fprintf(w, "Custom time %v\n", attrs.CustomTime)
  fmt.Fprintf(w, "Retention: %+v\n", attrs.Retention)
  fmt.Fprintf(w, "\n\nMetadata\n")
  for key, value := range attrs.Metadata {
    fmt.Fprintf(w, "\t%v = %v\n", key, value)
  }
  return attrs, nil
}

Excluir arquivos vs. excluir metadados no Google Drive

Se o que você quer é excluir um arquivo do DriveComo proprietário, você pode movê-lo da web para a lixeira clicando com o botão direito do mouse e escolhendo Mover para a Lixeira. Se o proprietário for outra pessoa, você só poderá "Remover" o arquivo da sua visualização; outras pessoas ainda poderão vê-lo.

Pára Para excluir um arquivo permanentemente, você deve esvaziar a lixeira ou usar a opção de exclusão permanente, Nesse caso, você não poderá recuperá-lo. Isso, por si só, não "remove metadados" de outros arquivos — aplica-se apenas àquele item.

Você não pode excluir metadados no Google Drive de arquivos que não são seus, porque seu controle pertence à pessoa que os criou ou a alguém com permissões mais altas dentro da organização. Nesses casos, você simplesmente remove seu acesso ou visibilidade.

Relacionando-o com metadados: A exclusão de um arquivo exclui seus metadados no Drive junto com ele, mas não afeta metadados em outras cópias ou metadados incorporados em outros documentos que permanecem no sistema.

Com tudo isso você já consegue diferenciar bem Quais metadados o Drive controla (nome, tags, dicas de pesquisa e miniaturas), como consultá-los via REST, quais práticas recomendadas seguir para limpar dados incorporados antes do upload e quais limites e permissões entram em jogo quando você encontra documentação do Google Cloud que fala sobre “metadados” em outros contextos.