- In Drive, le uniche cose che possono essere rimosse sono le etichette; il testo indicizzabile e le miniature vengono gestiti aggiornandone il contenuto.
- Le proprietà del sistema (dimensioni, timestamp) non vengono cancellate; è necessario comprenderne i limiti e la funzione.
- Se si esegue il trasferimento su Cloud Storage, alcuni metadati vengono conservati e altri no; pianificare di conseguenza.
- I metadati delle VM in Compute Engine hanno limiti e autorizzazioni specifici, diversi da quelli di Drive.
Elimina i metadati su google drive
Se ti preoccupano le informazioni aggiuntive che accompagnano i tuoi file nel cloud, probabilmente ti sarai chiesto come ripulire o controllare questi dati invisibili. In Google Drive, i metadati spaziano dai tag e dal testo indicizzabile alle miniature e alle proprietà dei file. La chiave sta nel capire cosa si può rimuovere, cosa si può solo aggiornare e cosa non si può modificare , in modo da poter agire con precisione senza causare danni.
In questa guida, abbiamo raccolto in un unico luogo informazioni sparse in diverse documentazioni ufficiali e articoli di supporto di Google. Imparerai come rimuovere i metadati dei tag da un file, gestire il testo indicizzabile e le miniature e comprendere limiti ed eccezioni . Chiariremo anche scenari simili (trasferimenti di Cloud Storage e metadati delle macchine virtuali in Compute Engine) per evitare confusione se lavori con Google Cloud.
Cosa sono i metadati in Drive e quanto è esteso il termine?
In Google Drive, i metadati includono informazioni come nome, tipo MIME, estensione dedotta, etichette, testo indicizzabile e miniature associate. Alcuni elementi sono modificabili o eliminabili (ad esempio, le etichette), altri vengono aggiornati indirettamente (testo indicizzabile e miniature) e altri ancora non possono essere eliminati perché fanno parte del sistema (come la dimensione del file o le date interne di creazione e aggiornamento).
Vedrai riferimenti ai metadati anche in altri prodotti Google Cloud, come Cloud Storage o Compute Engine. Non bisogna confondere i metadati di una VM o di un oggetto in Cloud Storage con quelli di un file Drive.; condividono il concetto, ma la loro gestione e i loro limiti sono diversi.
Gestisci i metadati in Drive
Cosa può essere effettivamente rimosso in Drive
Da un punto di vista pratico, ciò che comunemente viene considerato "rimozione dei metadati" in Drive è la rimozione delle etichette applicate a un file. Le etichette possono contenere campi (testo, utente, ecc.) e la loro rimozione elimina le informazioni associate dal file . Questa eliminazione viene eseguita tramite API utilizzando operazioni atomiche.
Il testo indicizzabile (contentHints.indexableText) non viene semplicemente "eliminato" con un pulsante; viene sovrascritto o lasciato vuoto quando si aggiorna la risorsa file . È progettato per migliorare la reperibilità dei tipi di file che Drive non indicizza nativamente.
Le miniature personalizzate vengono gestite in modo simile: è possibile caricare un'immagine di miniatura diversa oppure smettere di fornirne una . Se Drive è in grado di generare una miniatura standard, utilizzerà la propria; in caso contrario, utilizzerà quella fornita dall'utente.
Alcuni metadati in Drive, come le dimensioni dei file e i timestamp interni, non possono essere eliminati. Queste proprietà di sistema vengono aggiornate dal servizio stesso e non possono essere eliminate direttamente.
Rimuovere le etichette da un file in Google Drive
L'API Drive consente di modificare o rimuovere le etichette utilizzando il metodo files.modifyLabels. La richiesta include un oggetto di tipo ModifyLabelsRequest con una o più modifiche applicate in modo atomico. (se alcuni non sono validi, non si applica nulla).
Per rimuovere completamente un tag da un file, inviare un LabelModification con l'identificatore dell'etichetta e l'istruzione di cancellazione. Questo processo rimuove tutti i campi da quel tag nel file.Se hai bisogno di disattivare solo un campo specifico, puoi "deselezionare" quel campo senza rimuovere l'intero tag.
Passaggi concettuali per rimuovere un tag da un file specifico: 1) identifica il labelId dell'etichetta presente nel file (puoi elencarli con files.listLabels), 2) Invia la modifica con removeLabel attivato, 3) convalida che la risposta includa lo stato finale delle etichette aggiornate.
Testo indicizzabile: controllo, limiti e buone pratiche
Se la tua app salva tipi di file che Drive non indicizza da solo (disegni, video, collegamenti, ecc.), puoi aumentare la ricercabilità compilando contentHints.indexableText. Questo testo viene elaborato come HTML, indicizzato e potrebbe apparire nei riepiloghi dei risultati. su più superfici di ricerca.
Raccomandazioni e limitazioni importanti: la dimensione massima di indexableText è di 128 KB ; includere termini e concetti che descrivano effettivamente il contenuto; non tentare di ordinare il testo per pertinenza, l'indicizzatore lo fa già; aggiornare il testo a ogni salvataggio ; evitare di "riempire" il testo con parole chiave non correlate (finisce per frustrare gli utenti e può incoraggiare la cancellazione).
Tieni presente che, poiché viene trattato come HTML, viene indicizzato il contenuto testuale, non gli attributi . Ad esempio, se la tua stringa include tag con attributi, verrà indicizzato il testo visibile, non i valori di tali attributi.
Miniature: carica, sostituisci e recupera
Drive genera automaticamente miniature per Documenti, Fogli, Presentazioni e altri tipi di file. Se il tipo di file non genera una miniatura standard, puoi fornirne una. configurazione contentHints.thumbnail durante la creazione o l'aggiornamento del file.
Requisiti per le miniature personalizzate: utilizzare PNG, GIF o JPG; larghezza consigliata 1600 px (minimo 220 px); dimensione massima del file 2 MB; fornisce l'immagine codificata in base64 sicura per l'URL e mimeType corretta. La miniatura deve essere aggiornata ad ogni salvataggio, perché viene invalidato quando cambia il contenuto del file (le sole modifiche ai metadati non lo invalidano).
Per recuperare la miniatura, seleziona il campo thumbnailLink della risorsa files. Si tratta di un collegamento di breve durata che appare solo se la tua app riesce ad accedere al contenuto.Se il file non è pubblico, per utilizzare il collegamento saranno necessarie le credenziali.
Esempi di query di metadati con miniature tramite 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)
Nomi ed estensioni dei file: cosa dovresti sapere
Quando si inserisce un file tramite API, si consiglia di specificare l'estensione nella proprietà name (ad esempio, cat.jpg). L'unità propagherà tale estensione come fileExtension di sola lettura nelle risposte successivee quando l'utente scarica il file o lo sincronizza con il client desktop, il nome completo verrà generato in base al titolo.
Se non specifichi un'estensione, Drive tenterà di determinarla dal tipo MIME . Quando possibile, specificala per evitare sorprese.
Non confondere la rimozione dei metadati con l'eliminazione dei file.
Rimuovere i metadati ed eliminare i file sono due azioni diverse. Se sei il proprietario di un file e lo invii al Cestino, non stai cancellando i metadati, ma stai rimuovendo il file dal tuo disco . L'opzione "Elimina" (quando non sei il proprietario) si limita a nasconderlo a te, ma gli altri continueranno a vederlo.
Per spostare un file nel Cestino sul web: vai su drive.google.com, fai clic con il pulsante destro del mouse e seleziona Sposta nel Cestino . Se il file appartiene a qualcun altro, vedrai Rimuovi. Per eliminare definitivamente il file, svuota il Cestino. Nessuna di queste procedure rimuove i metadati dal file: puoi eliminare il file o gestirne i metadati utilizzando le opzioni descritte.
Trasferimenti e conservazione dei metadati di Cloud Storage (nel caso in cui si spostino i dati)
Quando si utilizza il servizio di trasferimento dati da/verso l'archiviazione cloud, esistono regole che stabiliscono quali metadati vengono conservati e quali no. Questo è fondamentale se si utilizza Drive con i bucket o se si migrano dati tra diversi cloud.
Da Amazon S3 o compatibile con Cloud Storage
- Sono conservati campi di metadati a chiave fissa (ad esempio, Cache-Control, Content-Disposition, Content-Type).
- I metadati definiti dall'utente vengono passati a metadati personalizzati in Cloud Storage (modificabile).
- El
ETagViene salvato come personalizzato con la chiavex-goog-source-etag. - La dimensione dell'oggetto viene conservata come
size. - Elenchi di controllo degli accessi S3 e tag degli oggetti: non sono conservati.
- Metadati timestamp S3: non sono conservati. Nell'archiviazione cloud,
timeCreatedyupdatedriflettono il momento della creazione/aggiornamento a destinazione. - Classe di archiviazione: configurabile durante il trasferimento (per impostazione predefinita, quella del bucket di destinazione).
Da Microsoft Azure Blob a Cloud Storage
- Campi metadati chiave fissi: sono conservati.
- Metadati definiti dall'utente: vengono salvati come personalizzati nell'archiviazione cloud.
ETagSi conserva comex-goog-source-etag.- Dimensioni come
sizeAutorizzazioni POSIX ADLS Gen2 e controllo di accesso specifico: non sono conservati. - Metadati di Azure Timestamp: non sono conservati.
timeCreated/updatedvengono ricalcolati a destinazione. - Classe di archiviazione: configurabile come nel caso di S3.
Tra i bucket di Cloud Storage
- Metadati chiave fissi e personalizzati: sono conservati.
- Generazione di oggetti: salvati come metadati personalizzati
x-goog-reserved-source-generation. - Conservazioni: le conservazioni temporanee vengono conservate per impostazione predefinita; le conservazioni basate sugli eventi non lo sono. Attenzione all'LCA: Puoi conservarli, ma evita di creare oggetti inaccessibili.
- Classe di archiviazione: mantieni, impostane una nuova o usa quella del bucket di destinazione.
- Crittografia CMEK: facoltativo da mantenere; per impostazione predefinita viene utilizzato il metodo del bucket di destinazione.
timeCreatedpuò essere conservato incustomTime;updatedno.- Altri metadati non modificabili (ad esempio,
etag,componentCount): no.
Elenchi di URL per Cloud Storage
- Campi metadati chiave fissi: modificabile a destinazione.
Content-LengthyMD5: non modificabile e vengono conservati se la fonte li fornisce.- Timestamp di origine: noClasse di archiviazione: configurabile.
Da POSIX a Cloud Storage (e viceversa)
mtimepersistenti come metadati personalizzatigoog-reserved-file-mtime.- La dimensione è conservata come
size. UID, GID, MODE e collegamenti simbolici: opzionale viametadataOptions. - In POSIX to POSIX, UID/GID/MODE possono essere conservati su file e cartelle;
mtimeViene salvato per i file (nelle cartelle viene utilizzata l'ora di creazione nella destinazione).
Questi dettagli sono importanti quando si trasferiscono dati tra servizi. Non aspettatevi che la cancellazione dei metadati in un sistema li faccia magicamente scomparire anche in un altro ; rispettate le regole di conservazione di ogni trasferimento.
Metadati di Compute Engine (VM): limiti ed eliminazione, se si utilizza Google Cloud
Sebbene non si tratti di Drive, molti team accedono ai metadati delle macchine virtuali in Compute Engine. Per gestire questa situazione, sono necessarie le autorizzazioni IAM appropriate e la conoscenza dei limiti di dimensione e ambito.
Prima di tutto: installa Google Cloud CLI ed eseguilo per la prima volta con gcloud init (Se utilizzi un provider di identità esterno, accedi in modalità federata.) Mantieni la CLI aggiornata con gcloud components update e imposta la regione e la zona predefinite per evitare errori di ambito.
Autorizzazioni tipiche richieste: se le VM utilizzano account di servizio, è obbligatorio iam.serviceAccounts.actAsPer i metadati a livello di progetto: compute.projects.get y compute.projects.setCommonInstanceMetadata. Per metadati zonali: compute.instanceSettings.get y compute.instanceSettings.updatePer i metadati su una VM specifica: compute.instances.get y compute.instances.setMetadata.
Limiti chiave: il set di metadati per VM ha un massimo combinato di 512 KB; ogni chiave fino a 128 byte e ogni valore fino a 256 KBLe chiavi SSH sono memorizzate in ssh-keys; se superi il limite, È ora di fare pulizia delle chiavi inutilizzateSe inserisci script di avvio/arresto come contenuto diretto, questi vengono conteggiati nel limite; invece, salva lo script su Cloud Storage e fornisce solo l'URL.
Maiuscolo/minuscolo: i tasti sono sensibili alle maiuscole e alle minuscole; anche i valori, ad eccezione dei valori booleani. Per i metadati zonali: gestiti solo con gcloud o REST; Non è possibile duplicare le chiavi con lo stesso testo cambiando il maiuscolo/minuscolo (ad esempio, creare ZONAL-METADATA-KEY se zonal-metadata-key esiste già); e non è possibile definire valori zonali per ssh-keys.
I valori booleani accettano equivalenti come VERO/FALSO e alternative come Y/Sì/1 e N/No/0, senza distinguere tra lettere maiuscole e minuscole.
Ambito e precedenza: lo stesso nome di chiave può esistere sia a livello di progetto che a livello di zona, ma il valore zonale ha la precedenza nella sua zona . Se si aggiunge un valore zonale, questo viene utilizzato per le VM in quella zona anche se esiste un valore a livello di progetto; l'aggiunta di un valore di progetto non sovrascrive i valori zonali esistenti.
Operazioni comuni: è possibile configurare i metadati di progetto (applicabili a tutte le VM), i metadati di zona (che interessano tutte le VM in una zona all'interno di quel progetto) e i metadati di istanza (solo per una VM). Per rimuovere i metadati, gcloud o REST consentono di eliminare i metadati di progetto, di zona o di istanza a seconda delle necessità.
Utilizzo di REST in locale: gli esempi dell'API REST utilizzano le credenziali fornite alla CLI di gcloud. Autentica il tuo ambiente e riutilizza tali credenziali per testare le chiamate dalla tua macchina.
Suggerimenti pratici per una migliore igiene dei metadati in Drive
Se vuoi ridurre l'ingombro dei tuoi file su Drive, concentrati su ciò che puoi controllare: etichette (rimuovile se non aggiungono valore), testo indicizzabile (modificalo o svuotalo se non ti serve) e miniature (sostituiscile o evita di caricarle) . Le proprietà di sistema servono per la verifica, non per l'eliminazione.
Quando un file viene condiviso e non ne sei il proprietario, ricorda che rimuoverlo dalla tua visualizzazione non elimina nulla per gli altri. Contatta il proprietario se l'obiettivo è rimuovere completamente il contenuto o i metadati associati.
Se integri Drive con flussi in Cloud Storage o con macchine virtuali, documenta le aspettative. Molti metadati cambiano o non vengono trasferiti tra i sistemi ; evita automazioni che si basano su timestamp o ACL che non vengono conservati.
Grazie a queste linee guida, avrai il controllo su ciò che conta davvero. Gestisci i tag con precisione, controlla cosa è indicizzabile e decidi quando e come utilizzare le miniature per trovare il giusto equilibrio tra privacy, reperibilità nei risultati di ricerca ed esperienza utente.
