Gestire i metadati dei file

Questo documento contiene considerazioni importanti per la denominazione dei file e l'utilizzo come testo indicizzabile e miniature. Per inserire e recuperare file, vedi la risorsa files.

Specificare i nomi e le estensioni dei file

Le app devono specificare un'estensione del file nella proprietà title durante l'inserimento dei file con l'API Google Drive. Ad esempio, un'operazione per inserire un file JPEG e specificare nei metadati un elemento simile a "name": "cat.jpg".

Le risposte GET successive possono includere la proprietà fileExtension di sola lettura compilata con l'estensione specificata originariamente nella proprietà name. Quando Gli utenti di Google Drive richiedono di scaricare un file o quando il file viene scaricato tramite il client di sincronizzazione, Drive crea un nome file completo (con (estensione)) in base al titolo. Se l'estensione non è presente, Drive cerca di determinare l'estensione in base al tipo MIME.

Salva testo indicizzabile

Drive indicizza automaticamente i documenti per le ricerche riconosce il tipo di file, inclusi documenti di testo, PDF, immagini con testo e e altri tipi comuni. Se la tua app salva altri tipi di file (ad esempio disegni, video e scorciatoie), puoi migliorare la rilevabilità fornendo testo indicizzabile nel campo contentHints.indexableText del file.

Il testo indicizzabile viene indicizzato come HTML. Se salvi la stringa di testo indicizzabile <section attribute="value1">Here's some text</section>, poi "Ecco alcune testo" è indicizzato, ma "value1" non lo è. Per questo motivo, salvare i file XML non è utile quanto salvare il codice HTML.

Quando specifichi indexableText, tieni presente anche quanto segue:

  • Il limite per le dimensioni di contentHints.indexableText è 128 kB.
  • Acquisisci i termini e i concetti chiave che ti aspetti vengano cercati dagli utenti.
  • Non cercare di ordinare il testo in ordine di importanza perché lo fa l'indicizzatore in modo efficiente.
  • L'applicazione dovrebbe aggiornare il testo indicizzabile a ogni salvataggio.
  • Assicurati che il testo sia correlato ai contenuti o ai metadati del file.

Quest'ultimo punto può sembrare ovvio, ma è importante. Non è una buona idea aggiungi termini di ricerca comune per forzare la visualizzazione di un file nei risultati di ricerca. Questo potrebbero infastidire gli utenti e potrebbero persino spingerli a eliminare il file.

Caricare le miniature

Drive genera automaticamente miniature per molti file comuni di testo, come Documenti, Fogli e Presentazioni Google. Le miniature aiutano l'utente a identificare meglio i file di Drive.

Per i tipi di file per cui Drive non può generare una miniatura standard puoi fornire un'immagine in miniatura generata dalla tua applicazione. Durante per la creazione o l'aggiornamento di un file, carica una miniatura impostando campo contentHints.thumbnail nella risorsa files.

In particolare:

  • Imposta il campo contentHints.thumbnail.image sull'URL e sul nome file sicuro immagine con codifica base64 (consulta la sezione RFC 4648 5).
  • Imposta il campo contentHints.thumbnail.mimeType sul tipo MIME appropriato per la miniatura.

Se Drive può generare una miniatura dal file, utilizza la classe ne viene generata automaticamente una e ignora tutti gli eventuali caricamenti. In caso contrario genera una miniatura, utilizza quella da te fornita.

Le miniature devono rispettare queste regole:

  • Possono essere caricate in formato PNG, GIF o JPG.
  • La larghezza consigliata è di 1600 pixel.
  • La larghezza minima è di 220 pixel.
  • La dimensione massima del file è 2 MB.
  • Dovrebbero essere aggiornati dall'applicazione a ogni salvataggio.

Per maggiori informazioni, consulta la risorsa files.

Recuperare le miniature

Puoi recuperare i metadati, incluse le miniature, per i file di Drive. Le informazioni sulle miniature si trovano nel campo thumbnailLink della Risorsa files.

Restituire una miniatura specifica

Il seguente esempio di codice mostra un files.get del metodo con più campi come parametro di query per restituire i metadati thumbnailLink per di un file specifico. Per ulteriori informazioni, vedi Restituire campi specifici per una .

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

Sostituisci FILE_ID con il valore fileId del file da modificare da trovare.

Se disponibile, la richiesta restituisce un URL di breve durata alla miniatura del file. In genere, il link dura diverse ore. Il campo viene compilato solo se l'app richiedente può accedere ai contenuti del file. Se il file non è condiviso pubblicamente, l'URL restituito in thumbnailLink deve essere recuperato utilizzando un richiesta con credenziali.

Restituire un elenco di miniature

Il seguente esempio di codice mostra un files.list del metodo con più campi come parametro di query per restituire i metadati thumbnailLink per un elenco di file. Per ulteriori informazioni, consulta la sezione Cercare file e cartelle.

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

Per limitare i risultati di ricerca a un tipo di file specifico, applica una stringa di query a e impostare il tipo MIME. Ad esempio, il seguente esempio di codice mostra come limitare il ai file di Fogli Google. Per ulteriori informazioni sui tipi MIME, consulta MIME supportato da Google Workspace e Google Drive di classificazione.

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