L'API Google Drive supporta diversi tipi di azioni di download ed esportazione, elencati nella seguente tabella:
Download |
|
|||
Esportazioni |
|
Prima di scaricare o esportare il contenuto del file, verifica che gli utenti possano scaricarlo utilizzando il campo capabilities.canDownload
nella risorsa files
.
Il resto della guida fornisce istruzioni dettagliate per eseguire questi tipi di azioni di download ed esportazione.
Scarica i contenuti del file BLOB
Per scaricare un file BLOB archiviato su Drive, utilizza il metodo files.get
con l'ID del file da scaricare e il parametro URL alt=media
. Il parametro URL alt=media
indica al server che è stata richiesta un download di contenuti come formato di risposta alternativo.
Il parametro URL alt=media
è un parametro di sistema disponibile in tutte le API REST Google. Se utilizzi una libreria client per l'API Drive, non è necessario impostare questo parametro in modo esplicito.
Il seguente esempio di codice mostra come utilizzare il metodo files.get
per scaricare un file con le librerie client dell'API Drive.
Java
Python
Node.js
PHP
.NET
Questo esempio di codice utilizza un metodo della libreria che aggiunge il parametro URL alt=media
alla richiesta HTTP sottostante.
I download di file avviati dall'app devono essere autorizzati con un ambito che consenta l'accesso in lettura ai contenuti del file. Ad esempio, un'app che utilizza l'ambito drive.readonly.metadata
non è autorizzata a scaricare i contenuti del file.
Questo esempio di codice utilizza l'ambito file "Drive" con restrizioni, che consente agli utenti di visualizzare e gestire tutti i tuoi file di Drive. Per scoprire di più sugli ambiti di Drive, consulta Scegliere gli ambiti dell'API Google Drive.
Gli utenti con autorizzazioni di modifica possono limitare il download agli utenti di sola lettura impostando il campo copyRequiresWriterPermission
su false
.
I file identificati come abusi (ad esempio software dannoso) possono essere scaricati solo dal proprietario dei file.
Inoltre, è necessario includere il parametro di query get
acknowledgeAbuse=true
per indicare che l'utente ha accettato il rischio di scaricare software potenzialmente indesiderato o altri file illeciti. L'applicazione deve avvisare in modo interattivo l'utente prima di utilizzare questo parametro di query.
Download parziale
Il download parziale prevede il download solo di una parte specificata di un file. Puoi specificare la parte del file che desideri scaricare utilizzando un intervallo di byte con l'intestazione Range
. Ad esempio:
Range: bytes=500-999
Scarica i contenuti del file BLOB in una versione precedente
Per scaricare i contenuti dei file BLOB in una versione precedente, utilizza il metodo revisions.get
con l'ID del file da scaricare, l'ID della revisione e il parametro URL alt=media
.
Il parametro URL alt=media
indica al server che è stata richiesta un download di contenuti come formato di risposta alternativo. Come per files.get
, il metodo revisions.get
accetta anche il parametro di query facoltativo acknowledgeAbuse
e l'intestazione Range
. Per maggiori informazioni sul download delle revisioni, vedi Scaricare e pubblicare le revisioni dei file.
Scaricare i contenuti del file BLOB in un browser
Per scaricare i contenuti dei file BLOB archiviati su Drive all'interno di un browser, anziché tramite l'API, utilizza il campo webContentLink
della risorsa files
. Se l'utente ha accesso in download al file, viene restituito un link per scaricare il file e i relativi contenuti. Puoi reindirizzare un utente a questo URL o offrirlo come link cliccabile.
Esporta i contenuti dei documenti di Google Workspace
Per esportare i contenuti in byte dei documenti di Google Workspace, utilizza il metodo files.export
con l'ID del file da esportare
e il tipo MIME corretto. La dimensione massima dei contenuti esportati è 10 MB.
Il seguente esempio di codice mostra come utilizzare il metodo files.export
per esportare un documento di Google Workspace in formato PDF utilizzando le librerie client dell'API Drive:
Java
Python
Node.js
PHP
.NET
Questo esempio di codice utilizza l'ambito drive
con restrizioni, che consente agli utenti di visualizzare e
gestire tutti i tuoi file di Drive. Per scoprire di più sugli ambiti di Drive, consulta Scegliere gli ambiti dell'API Google Drive.
Anche nell'esempio di codice il tipo MIME di esportazione è application/pdf
. Per un elenco completo di tutti i tipi MIME di esportazione supportati per ogni documento di Google Workspace, vedi Esportare i tipi MIME per i documenti di Google Workspace.
Esporta i contenuti dei documenti di Google Workspace in un browser
Per esportare i contenuti dei documenti di Google Workspace all'interno di un browser, utilizza il campo exportLinks
della risorsa files
. A seconda del tipo di documento, viene restituito un link per scaricare il file e i relativi contenuti per ogni tipo MIME disponibile. Puoi reindirizzare un utente a un URL o offrirlo come link cliccabile.
Esportare i contenuti dei documenti di Google Workspace in una versione precedente in un browser
Per esportare i contenuti dei documenti di Google Workspace in una versione precedente all'interno di un browser, utilizza il metodo revisions.get
con l'ID del file da scaricare e l'ID della revisione. Se l'utente dispone dell'accesso per scaricare il file, viene restituito un link per scaricare il file e i suoi contenuti. Puoi reindirizzare un utente a questo URL o offrirlo come link cliccabile.