Com eliminar les metadades a Google Drive

Vols controlar les metadades dels teus arxius a Google Drive i no saps per on començar? Aquí us expliquem, amb tot detall, com eliminar metadades a Google Drive de forma eficaç i segura (les metadades dels fitxers pujats). També t'expliquem quins límits imposa Google quant a noms, mides i permisos.

Amb aquesta guia tindràs una visió completa i realista de què es pot (i què no) “eliminar” quan parlem de metadades a Google Drive.

Què es pot canviar o “eliminar” a Drive

Aquests són els metadades que es poden eliminar dels fitxers pujats a Google Drive:

Nom i extensió: en crear un fitxer via API, convé especificar l'extensió al camp name, per exemple «cat.jpg». Drive pot inferir l'extensió a partir del tipus MIME si no la indiques, però és millor definir-la tu. En respostes posteriors, podeu aparèixer fileExtension de només lectura amb l'extensió propagada des de name. Si un usuari baixa el fitxer, Drive compon el nom final partint del títol (i la seva extensió).

• Text indexable (contentHints.indexableText): Drive indexa per defecte documents i tipus comuns (PDFs, imatges amb OCR, etc.). Si la teva app desa altres formats (dibuixos, vídeos, dreceres), pots subministrar text indexable per millorar la cerca. Aquest text es processa com a HTML: si passes una cadena amb etiquetes, s'indexa el contingut textual, no els atributs de les etiquetes. Hi ha un límit de mida de 128 KB per a contentHints.indexableText i es recomana actualitzar-lo a cada desament i mantenir-lo rellevant respecte al fitxer.
• Miniatures (contentHints.thumbnail): Drive genera miniatures per a molts tipus, però per a formats que no l'obtenen automàticament, podeu pujar la vostra en crear o actualitzar el fitxer. Heu d'establir la imatge a base64 segura per a URL i el mimeType corresponent. Regles clau: formats admesos PNG, GIF o JPG; ample recomanat de 1600 px (mínim 220 px) i mida màxima 2 MB. Les miniatures s'invaliden quan canvieu el contingut del fitxer; els canvis de metadades no les invaliden.
• Accés a miniatures: el camp thumbnailLink retorna una URL de curta durada, accessible només si l'app té permís per llegir el fitxer (si no és públic, hauràs de sol·licitar-la amb credencials). Pots consultar-la per a un fitxer concret o per a una llista filtrada per tipus.
• Etiquetes (labels): Drive permet associar etiquetes a fitxers. Per localitzar-les pots fer servir files.listLabels, i per modificar-les has de referenciar el labelId i el fileId corresponents. Aquest mecanisme és útil per categoritzar i, arribat el cas, “netejar” classificació no desitjada sense tocar-ne el contingut.

Eliminar metadades a Google Drive: metadades “ocultes” del propi fitxer

No hi ha cap botó màgic per eliminar metadades a Google Drive (com EXIF ​​en fotos o dades incrustades en PDFs). Drive gestiona metadades pròpies de la plataforma, però les metadades que viuen dins del fitxer depenen de l'eina que el va crear.

La pràctica recomanada és netejar el fitxer abans de pujar-lo a Drive, usant eines del sistema o apps especialitzades que treuen EXIF ​​d'imatges o propietats de documents. Així, el contingut que guardis a Drive ja arriba “higienitzat”.

Si ja teniu fitxers pujats amb metadades incrustades, en lloc d'eliminar metadades a Google Drive, és més convenient descarregar, netejar i tornar a pujar, reemplaçant l'original si escau. Amb PDFs o imatges, això és habitual quan busqueu protegir dades d'autor, ubicació o historial d'edició.

Per a la part específica de Drive, centra't en ajustar name, labels i contentHints (indexableText/thumbnail), que sí que estan sota el teu control. Si a més gestions permisos d'accés, també reduïxes exposició de metadades visibles (per exemple, enllaços de miniatura accessibles a qui té lectura).

No oblidis que canviar només metadades de Drive no elimina EXIF ​​ni propietats internes. Per això, la teva estratègia ha de combinar neteja prèvia del fitxer amb la gestió fina de metadades que Drive sí permet tocar.

Metadades a Google Cloud que solen confondre's: VMs, gcloud i límits

Si treballes amb Google Cloud, en veuràs moltes guies sobre “metadades” que en realitat es refereixen a Compute Engine o Cloud Storage, no a Drive. Tot i així, t'interessa conèixer aquests punts per no barrejar-los en documentar-te.

Configuració bàsica de gcloud CLI

Després d'instal·lar Google Cloud CLI, inicialitza amb:

gcloud init

És important assegurar-nos de tenir la versió més recent amb:

gcloud components update

Si utilitzeu un proveïdor d'identitat extern, inicia sessió amb la teva identitat federada abans de treballar amb gcloud, sobretot si t'autenticaràs per fer trucades REST des del teu entorn local. Les mostres d'API REST poden utilitzar les credencials que heu configurat a gcloud.

VM

Permisos i rols (Compute Engine): per afegir, actualitzar o eliminar metadades personalitzades a VMs necessites permisos d'IAM adequats. Exemples habituals:

• Si els vostres VMs usen comptes de servei: permís iam.serviceAccounts.actAs al compte de servei o projecte.
• Metadades del projecte: compute.projects.get y compute.projects.setCommonInstanceMetadata.
• Metadades zonals: compute.instanceSettings.get y compute.instanceSettings.update per a la zona pertinent.
• Metadades d'instància: compute.instances.get y compute.instances.setMetadata.

limitacions

Aquestes són les principals limitacions amb què ens trobem en intentar eliminar metadades a Google Drive:

• Limitacions de mida (Compute Engine): el total combinat d'entrades de metadades té un topall de 512 KB. Cada clau (key) té límit de 128 bytes i cada valor (value) de 256 KB. Si, per exemple, utilitzeu la clau ssh-keys i supereu el límit de 256 KB, no podreu afegir més claus fins a netejar.
• Majúscules i minúscules: les claus distingeixen majúscules/minúscules; els valors també, llevat dels booleans. A zonals, no pots crear dues claus que difereixin només pel cas (zonal-metadata-key vs ZONAL-METADATA-KEY).
• Metadades zonals: s'estableixen o s'eliminen amb gcloud o REST. No podeu definir valors zonals per a claus SSH (ssh-keys). Al directori lògic project/, si hi ha valors a nivell projecte i zonal per a la mateixa clau, el valor zonal té prioritat a la vostra zona.
• Valors booleans admesos: a més de TRUE/FALSE, pots utilitzar I/Yes/1 i N/No/0 (no distingeixen majúscules/minúscules).
• Àmbits de configuració (Compute Engine):
  • Projecte: metadades comunes a totes les VMs del projecte.
  • Zonal: entrades que afecten totes les VM d'una zona concreta i poden anul·lar el valor de projecte.
  • Instància: metadades per a una VM concreta (en creació o ja existent).

Miniatures, indexació i recuperació de metadades a Drive (REST i bones pràctiques)

Vegem ara el paper de les miniatures a l'hora d'eliminar metadades a Google Drive. I també el millor mètode de recuperar-los:

• Autenticació per a REST en local: si voleu provar exemples REST des de la vostra màquina, utilitzeu les credencials configurades amb gcloud. Així, les teves trucades a l'API de Drive respectaran la identitat i els permisos que ja hagis establert.
• Pujada de miniatures personalitzades: estableix contentHints.thumbnail amb dos camps: la imatge a base64 “segura per a URL” i el mimeType correcte. Si Drive pot generar miniatura automàticament, utilitzarà la seva i ometrà la teva. Si no, utilitzareu la que proporcioneu.

Regles clau de miniatures a Drive:

• Formats: PNG, GIF o JPG.
• Ample recomanat: 1600 px (mínim 220 px).
• Grandària màxima: 2 MB.
• Actualitza la miniatura amb cada desament si continua sent rellevant.

Important sobre invalidació: les miniatures s'invaliden en canviar el contingut del fitxer; els canvis de metadades no les invaliden. Si canvieu només etiquetes o el nom, no espereu una miniatura nova, llevat que modifiqueu el fitxer.

Text indexable

No intenteu “enganyar” la cerca amb termes de moda. Captura conceptes i termes que un usuari raonablement buscaria per a aquest fitxer, i revisa el límit de 128 KB. Actualitza'l cada cop que el contingut canviï de forma substancial.

Aplica noms i extensions coherents. Sempre que puguis, inclou l'extensió en name en pujar; si falta, Drive intentarà inferir-la per MIME. Mantenir noms clars us evitarà ambigüitats i us permetrà cerques més senzilles per extensió.

Etiquetes a Drive

Per modificar etiquetes, apunta els identificadors necessaris. Necessitareu el labelId de l'etiqueta i el fileId del fitxer. Abans podeu llistar-les amb files.listLabels i, després, aplicar els canvis corresponents sobre el fitxer objectiu.

// 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.

Recorda que, encara que Drive és el focus, molts desenvolupaments combinen Drive amb Cloud Storage o altres serveis, per això veieu exemples de Storage per inspeccionar atributs d'objectes.

// 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
}

Eliminar fitxers vs eliminar metadades a Google Drive

Si el que vols és esborrar un fitxer de Drive, com a propietari pots enviar-lo a la paperera des de la web, fent clic dret i escollint Moure a la paperera. Si el propietari és una altra persona, només podràs “treure” el fitxer de la teva vista; altres seguiran veient-ho.

Per a eliminar definitivament un fitxer, has de buidar la paperera o utilitzar l'opció d'eliminació permanent, en aquest cas no podràs recuperar-ho. Això, per si sol, no “elimina metadades” d'altres fitxers: només s'aplica a aquest element.

No podeu suprimir metadades a Google Drive de fitxers dels quals no sou propietaris, perquè el control pertany a qui els va crear oa qui tingui permisos superiors dins de l'organització. En aquests casos, només retires el teu accés o visibilitat.

Relacionant-ho amb metadades: eliminar un fitxer elimina les seves metadades a Drive juntament amb ell, però no afecta metadades d'altres còpies ni metadades incrustades d'altres documents que segueixin al sistema.

Amb tot això, ja pots diferenciar bé quines metadades controla Drive (nom, etiquetes, pistes per a cerca i miniatures), com consultar-los per REST, quines pràctiques seguir per netejar dades incrustades abans de pujar, i quins límits i permisos entren en joc quan et topes amb documentació de Google Cloud que parla de “metadades” en altres contextos.