Cumu caccià i metadati in Google Drive

Vulete cuntrullà i metadati di i vostri fugliali in Google Drive è ùn sapete micca induve principià ? Quì vi spieghemu, in dettagliu, Cumu caccià i metadati in Google Drive in modu efficace è sicuru (i metadati di i fugliali caricati). Vi dicemu ancu quali limiti impone Google à i nomi di i fugliali, e dimensioni è i permessi.

Questa guida vi darà una comprensione cumpleta è realistica di ciò chì pò (è ùn pò micca) esse "sguassatu" quandu si tratta di metadati in Google Drive.

Ciò chì pò esse cambiatu o "sguassatu" in Drive

Questi sò u metadata chì ponu esse eliminati da i fugliali caricati in Google Drive:

Nome è estensione: Quandu si crea un schedariu via l'API, hè una bona idea di specificà l'estensione in u campu di nome, per esempiu, "cat.jpg". Drive pò deduce l'estensione da u tipu MIME s'ellu ùn hè micca specificatu, ma hè megliu definisce lu voi stessu. In e risposte successive, un fileExtension di sola lettura pò cumparisce cù l'estensione pupulata da nome. Se un utilizatore scarica u schedariu, Drive compila u nome finale da u titulu (è a so estensione).

• Testu indicizabile (contentHints.indexableText): Drive indicizza i ducumenti è i tipi cumuni (PDF, imagine abilitate per OCR, ecc.) per difettu. Sè a vostra applicazione salva altri furmati (disegni, video, scorciatoie), pudete furnisce testu indicizzabile per migliurà a ricerca. Stu testu hè trattatu cum'è HTML: sè passate una stringa chì cuntene tag, u cuntenutu testuale hè indicizatu, micca l'attributi di i tag. Ci hè un limite di dimensione di 128 KB per contentHints.indexableText, è hè cunsigliatu di aghjurnallu à ogni salvamentu è di mantene lu pertinente à u schedariu.
• Miniature (contentHints.thumbnail): Drive genera miniature per parechji tipi, ma per i furmati chì ùn li generanu micca automaticamente, pudete caricare e vostre quandu create o aghjurnate u schedariu. Duvete impostà l'imagine à base64 sicuru per URL è u mimeType currispundente. Regole chjave: I furmati supportati sò PNG, GIF o JPG; a larghezza cunsigliata hè 1600px (minimu 220px) è a dimensione massima hè 2MB. E miniature sò invalidate quandu u cuntenutu di u schedariu cambia; i cambiamenti di metadati ùn cambianu micca.
• Accessu à e miniature: U campu ThumbnailLink restituisce un URL cortu, accessibile solu s'è l'applicazione hà u permessu di leghje u schedariu (s'ellu ùn hè micca publicu, duverete dumandallu cù credenziali). Pudete dumandallu per un schedariu specificu o per una lista filtrata per tipu.
• Etichette: Drive vi permette d'associà etichette cù fugliali. Per localizà li, pudete aduprà files.listLabels, è per mudificà li, duvete fà riferimentu à u labelId è u fileId currispondenti. Stu mecanismu hè utile per categurizà è, se necessariu, "pulisce" classificazioni indesiderate senza tuccà u cuntenutu.

Sguassà i metadati in Google Drive: metadati "nascosti" da u schedariu stessu

Ùn ci hè micca un buttone magicu per caccià i metadati in Google Drive (cum'è EXIF ​​​​in e foto o dati integrati in PDF). Drive gestisce i so propri metadati, ma i metadati in u schedariu dipendenu da u strumentu chì l'hà creatu.

A pratica cunsigliata hè pulisce u schedariu prima di caricallu in Drive, Aduprendu strumenti di sistema o app specializate chì eliminanu i dati EXIF ​​da l'imagine o da e proprietà di i documenti. In questu modu, u cuntenutu chì salvate in Drive ghjunghje "sanitizatu".

Sè vo avete digià i fugliali caricati cù metadati integrati, invece di caccià i metadati in Google Drive, hè più cunveniente scaricate, pulite è ricaricate, rimpiazzendu l'uriginale s'ellu hè applicabile. Cù PDF o imagine, questu hè cumunu quandu vulete prutege l'autore, a situazione geografica o a storia di mudificazione.

Per a parte specifica di Drive, cuncentratevi nantu à l'aghjustamentu di u nome, l'etichette è i suggerimenti di cuntenutu (indexableText/thumbnail), chì sò sottu à u vostru cuntrollu. Sè gestite ancu i permessi d'accessu, riducete ancu l'esposizione di i metadati visibili (per esempiu, i ligami di miniature accessibili à quelli chì anu diritti di lettura).

Ùn vi ne scurdate micca Cambià solu i metadati di Drive ùn elimina micca EXIF ​​​​o e proprietà interne. Dunque, a vostra strategia deve cumbinà a pre-pulizia di u schedariu cù a gestione fine di i metadati chì Drive vi permette di tuccà.

Metadati spessu cunfusi in Google Cloud: VM, gcloud è limiti

Sè travagliate cù Google Cloud, ne viderete parechji guide nantu à i "metadati" chì si riferiscenu in realtà à Compute Engine o Cloud Storage, micca à Drive. Ancu cusì, vulete cunnosce sti punti per ùn cunfondeli micca quandu fate a ricerca.

Cunfigurazione CLI di basa di gcloud

Dopu avè installatu Google Cloud CLI, inizializate cù:

gcloud init

Hè impurtante assicurassi chì avete l'ultima versione cù:

gcloud components update

Sè vo aduprate un fornitore d'identità esternu, Cunnettatevi cù a vostra identità federata prima di travaglià cù gcloud, soprattuttu s'è vo avete da autentificà vi per fà chjamate REST da u vostru ambiente lucale. L'esempii di l'API REST ponu aduprà e credenziali chì avete cunfiguratu in gcloud.

VM

Permessi è roli (Compute Engine): Per aghjunghje, aghjurnà o sguassà metadati persunalizati nantu à e VM, avete bisognu di permessi IAM adatti. Esempi cumuni includenu:

• Sè e vostre VM utilizanu conti di serviziu: permessu iam.serviceAccounts.actAs in u contu di serviziu o di prughjettu.
• Metadati di u prugettu: compute.projects.get y compute.projects.setCommonInstanceMetadata.
• Metadati zonali: compute.instanceSettings.get y compute.instanceSettings.update per a zona pertinente.
• Metadati di l'istanza: compute.instances.get y compute.instances.setMetadata.

Limitazioni

Quessi sò i principali limiti chì avemu scontru quandu pruvavamu à caccià i metadati in Google Drive:

• Limitazioni di dimensione (Compute Engine): U totale cumminatu di l'entrate di metadati hè limitatu à 512 KB. Ogni chjave hè limitata à 128 byte, è ogni valore hè limitatu à 256 KB. Sè, per esempiu, utilizate a chjave ssh-keys è superate u limite di 256 KB, ùn puderete micca aghjunghje più chjave finu à chì ùn pulite micca.
• Maiuscule è minuscule : E chjave sò sensibili à e maiuscule è minuscule; i valori sò ancu elli, eccettu per i Booleani. In zonale, ùn pudete micca creà duie chjave chì differenu solu in maiuscule è minuscule (zonal-metadata-key vs. ZONAL-METADATA-KEY).
• Metadati zonali: sò impostati o eliminati cù gcloud o REST. Ùn pudete micca definisce valori zonali per e chjave SSH (ssh-keys). In u cartulare logicu di u prughjettu/, s'ellu ci sò valori à livellu di prughjettu è zonali per a listessa chjave, u valore zonale hà a precedenza in a so zona.
• Valori booleani supportati: In più di VERU/FALSU, pudete aduprà Y/Iè/1 è N/Innò/0 (senza distinzione trà maiuscule è minuscule).
• Ambiti di cunfigurazione (Compute Engine):
  • Prughjettu: metadati cumuni à tutte e VM in u prugettu.
  • Zune: entrate chì affettanu tutte e VM in una zona particulare è ponu annullà u valore di u prugettu.
  • Istanza: metadati per una VM specifica (in corsu di creazione o digià esistente).

Miniature, indicizazione è recuperu di metadati in Drive (REST è migliori pratiche)

Avà guardemu u rolu di e miniature quandu si eliminanu i metadati in Google Drive. È dinò u megliu modu per recuperalli:

• Autentificazione per REST in situ: Sè vo pruvate esempi REST da u vostru urdinatore, aduprate l'infurmazioni d'accessu cunfigurate cù gcloud. In questu modu, e vostre chjamate à l'API Drive rispetteranu l'identità è i permessi chì avete digià stabilitu.
• Caricamentu di miniature persunalizate: Impostate contentHints.thumbnail cù dui campi: l'imagine base64 sicura per l'URL è u mimeType currettu. Se Drive pò generà automaticamente una miniatura, aduprerà a soia è salterà a vostra. Altrimenti, aduprerà quella chì furnite.

Regole chjave per e miniature in Drive:

• Formati: PNG, GIF o JPG.
• Larghezza cunsigliata: 1600 px (minimu 220 px).
• Dimensione massima: 2 MB.
• Aggiorna a miniatura cù ogni salvataggio s'ella hè sempre pertinente.

Impurtante nantu à invalidazione: E miniature sò invalidate quandu u cuntenutu di u schedariu hè cambiatu; e mudificazioni di i metadati ùn sò micca. Sè vo cambiate solu i tag o u nome, ùn aspettate micca una nova miniatura à menu chì ùn mudificate u schedariu.

Testu indicizabile

Ùn pruvate micca à "ingannà" a ricerca cù parolle à a moda. Catturà cuncetti è termini chì un utilizatore cercherebbe ragiunevolmente per quellu schedariu, è verificate u limite di 128KB. Aghjurnallu ogni volta chì u cuntenutu cambia sustanzialmente.

Applicà nomi è estensioni coerentiQuandu hè pussibule, include l'estensione in u nome quandu si carica; s'ella manca, Drive pruverà à deduce la per MIME. Mantene i nomi chjari eviterà ambiguità è permetterà ricerche di estensione più faciuli.

Etichette in Drive

Per mudificà l'etichette, nutate l'identificatori necessarii. Averete bisognu di l'labelId di l'etichetta è di l'fileId di u schedariu. Pudete prima elencalli cù files.listLabels è dopu applicà i cambiamenti currispondenti à u schedariu di destinazione.

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

Arricurdatevi chì, Ancu s'è Drive hè u puntu focale, parechji sviluppi combinanu Drive cù Cloud Storage o altri servizii, Cusì viderete esempi di Storage per ispezionà l'attributi di l'ughjettu.

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

Sguassà i fugliali vs. sguassà i metadati in Google Drive

Se quellu chì vulete hè sguassà un schedariu da DriveCum'è pruprietariu, pudete spustallu in a basura da u web clicchendu cù u dirittu è scegliendu Move to Trash. Se u pruprietariu hè qualcunu altru, pudete solu "Eliminà" u schedariu da a vostra vista; l'altri puderanu sempre vedelu.

sobre Per sguassà definitivamente un schedariu, duvete svuotà a basura o aduprà l'opzione di cancellazione permanente, In questu casu, ùn puderete micca recuperallu. Questu, da per ellu, ùn "elimina micca i metadati" da altri fugliali - s'applica solu à quellu articulu.

Ùn pudete micca sguassà i metadati in Google Drive da i fugliali chì ùn sò micca di u vostru pruprietariu, perchè u so cuntrollu appartene à a persona chì l'hà creati o à qualchissia cù permessi più alti in l'urganizazione. In questi casi, basta à caccià u vostru accessu o visibilità.

Relazione cù i metadati: Sguassà un schedariu elimina ancu i so metadati in Drive, ma ùn affetta micca i metadati in altre copie o i metadati integrati in altri documenti chì restanu in u sistema.

Cù tuttu ciò chì hè statu dettu sopra, pudete avà diferenzià bè Chì metadati Drive cuntrolla (nome, tag, suggerimenti di ricerca è miniature), cumu interrogalli via REST, chì pratiche megliu seguità per a pulizia di i dati integrati prima di caricalli, è chì limiti è permessi entranu in ghjocu quandu si trova a ducumentazione di Google Cloud chì parla di "metadati" in altri cuntesti.