Creare file

Per creare un file che non contiene metadati o contenuti, utilizza il metodo files.create senza parametri. Al file vengono assegnati kind di drive.file, id, name di "Senza titolo" e mimeType di application/octet-stream. uploadType è contrassegnato come obbligatorio, ma il valore predefinito è media, quindi non è necessario che tu lo fornisca.

Per ulteriori informazioni sui limiti dei file di Drive, vedi Limiti per file e cartelle.

Nota: quando un utente di Google Drive vuole scaricare un file o quando il file viene scaricato tramite il client di sincronizzazione, Drive crea un nome file completo (con estensione) basato sul nome. Se l'estensione non è presente, Drive tenta di determinarla in base al tipo MIME del file.

Creare file solo di metadati

I file di soli metadati non includono contenuti. I metadati sono dati (come name, mimeType e createdTime) che descrivono il file. I campi come name sono indipendenti dall'utente e vengono visualizzati nello stesso modo per ogni utente, mentre campi come viewedByMeTime contengono valori specifici dell'utente.

Un esempio di file solo metadati è una cartella con il tipo MIME application/vnd.google-apps.folder. Per ulteriori informazioni, consulta l'argomento Creare e compilare cartelle. Un altro esempio è una scorciatoia che rimanda a un altro file su Drive con il tipo MIME application/vnd.google-apps.shortcut. Per ulteriori informazioni, consulta Creare una scorciatoia a un file di Drive.

Carica miniature

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

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

In particolare:

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

Se Drive è in grado di generare una miniatura dal file, utilizza quella generata automaticamente e ignora qualsiasi tu abbia caricato. Se non può generare una miniatura, utilizza quella che hai fornito.

Le miniature devono rispettare le seguenti regole:

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

Importante: le miniature vengono invalidate ogni volta che vengono modificati i contenuti del file. Quando fornisci le miniature, è importante caricare nuove miniature ogni volta che vengono modificati i contenuti. Le modifiche ai metadati non invalidano le miniature.

Per ulteriori informazioni, consulta la risorsa files.

Argomenti correlati

Ecco alcuni passaggi che potresti provare a eseguire:

• Per caricare i dati del file quando crei o aggiorni un file, vedi Caricare i dati del file.

• Per creare un file in una cartella specifica, consulta Creare un file in una cartella specifica.