Creare e gestire file

Questa guida spiega come creare e gestire file su Google Drive.

Crea file

Per creare un file su Drive senza 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 fornirlo effettivamente.

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

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.

Gestire le immagini in miniatura

Le miniature aiutano gli utenti a identificare i file di Drive. Drive può generare automaticamente miniature per i tipi di file comuni oppure fornire un'immagine in miniatura generata dalla tua app. Per ulteriori informazioni, vedi Caricare miniature.

Copiare un file esistente

Per copiare un file e applicare gli aggiornamenti richiesti, utilizza il metodo files.copy. Per trovare il fileId da copiare, utilizza il metodo files.list.

Tieni presente che devi utilizzare un ambito dell'API Drive appropriato per autorizzare la chiamata. Per ulteriori informazioni sugli ambiti di Drive, consulta l'articolo Scegliere gli ambiti API di Google Drive.

Limiti e considerazioni

Mentre ti prepari a copiare i file, tieni presente i seguenti limiti e considerazioni:

  • Autorizzazioni:

    • La limitazione dei file copyRequiresWriterPermission determina chi può copiare il file. Per ulteriori informazioni, consulta Impedire agli utenti di scaricare, stampare o copiare il file.
    • Il campo capabilities/canCopy di una risorsa files determina se l'utente può copiare un file. Per ulteriori informazioni, consulta Funzionalità.
    • Il file copiato è di proprietà dell'utente che ha creato la copia. Nessun'altra impostazione di condivisione del file di origine viene replicata. Se viene creata in una cartella condivisa, la copia eredita le autorizzazioni di quella cartella.
    • La proprietà di un file copiato potrebbe cambiare e la copia potrebbe non ereditare le impostazioni di condivisione del file originale. Potrebbe essere necessario reimpostare queste impostazioni.

  • Gestione file:

    • Alcuni file, ad esempio le scorciatoie di terze parti, non possono mai essere copiati.
    • Puoi copiare un file solo in una cartella principale. La specifica di più padri non è supportata. Se il campo parents non viene specificato, il file eredita tutti gli elementi principali rilevabili dal file di origine.
    • Non puoi copiare una cartella anche se è un tipo di file. Crea invece una cartella di destinazione e imposta il campo parents dei file esistenti sulla cartella di destinazione. Puoi quindi eliminare la cartella di origine originale.
    • A meno che non venga specificato un nuovo nome file, il metodo files.copy produce un file con lo stesso nome dell'originale.
    • L'uso eccessivo di files.copy può comportare il superamento dei limiti di quota dell'API Drive. Per ulteriori informazioni, consulta Limiti di utilizzo.

Ecco alcuni passaggi che potresti provare a eseguire: