L'API Google Drive supporta diversi tipi di azioni di download ed esportazione, come: elencati nella tabella seguente:
Download |
|
|||
Esportazioni |
|
Prima di scaricare o esportare i contenuti dei file, verifica che gli utenti possano scaricare
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
server che richiede la richiesta di un download di contenuti come risposta alternativa.
formato.
Il parametro URL alt=media
è un sistema
parametro
disponibili in tutte le API REST Google. Se utilizzi una libreria client per
API Drive, non devi impostare esplicitamente questo parametro.
Il seguente esempio di codice mostra come utilizzare il metodo files.get
per scaricare un
con le librerie client dell'API Drive.
Java
Python
Node.js
PHP
.NET
Questo esempio di codice utilizza un metodo di libreria che aggiunge il parametro URL alt=media
alla richiesta HTTP sottostante.
I download di file avviati dalla tua app devono essere autorizzati con un ambito che consenta
accesso in lettura ai contenuti del file. Ad esempio, un'app che utilizza
L'ambito drive.readonly.metadata
non è autorizzato a scaricare i contenuti dei file.
Questo esempio di codice utilizza l'ambito del file "drive" limitato che consente agli utenti di
visualizzare e gestire tutti i tuoi file di Drive. Per scoprire di più su
Ambiti Drive, consulta Scegliere l'API Google Drive
ambiti.
Gli utenti con autorizzazioni di modifica possono limitare il download da parte degli utenti di sola lettura tramite
l'impostazione di copyRequiresWriterPermission
su false
.
File identificati come
abuso
(ad esempio software dannosi) possono essere scaricati solo dal proprietario dei file.
Inoltre, è necessario includere il parametro di query acknowledgeAbuse=true
get
per indicare che l'utente ha accettato il rischio di scaricare
software indesiderato o altri file illeciti. L'applicazione dovrebbe programmare
avvisa l'utente prima di utilizzare questo parametro di query.
Download parziale
Il download parziale prevede il download solo di una parte specifica di un file. Tu
puoi specificare la parte del file che vuoi scaricare utilizzando una dimensione byte
gamma
con l'intestazione Range
. Ad esempio:
Range: bytes=500-999
Scaricare i contenuti del file BLOB in una versione precedente
Per scaricare i contenuti dei file BLOB in una versione precedente, utilizza la classe
Metodo revisions.get
con l'ID di
il file da scaricare, l'ID della revisione e il parametro URL alt=media
.
Il parametro URL alt=media
indica al server che il download di contenuti
come formato di risposta alternativo. Analogamente a files.get
,
Il metodo revisions.get
accetta anche il parametro di query facoltativo
acknowledgeAbuse
e l'intestazione Range
. Per ulteriori informazioni sul download
revisioni, consulta l'articolo Scaricare e pubblicare
revisioni.
Scarica i contenuti del file blob in un browser
Per scaricare i contenuti dei file BLOB archiviati su Drive all'interno di un
utilizzare il browser, invece che tramite l'API
webContentLink
del
files
. Se l'utente ha eseguito il download
l'accesso al file, viene fornito un link per scaricarlo e i suoi contenuti
restituito. Puoi reindirizzare un utente a questo URL o offrirlo come URL cliccabile
.
Esporta i contenuti dei documenti di Google Workspace
Per esportare i contenuti byte dei documenti di Google Workspace, utilizza il metodo files.export
con l'ID del file da esportare
e il tipo MIME corretto. Esportato
contenuti ha un limite di 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 il client API Drive
librerie:
Java
Python
Node.js
PHP
.NET
Questo esempio di codice utilizza l'ambito drive
limitato che consente agli utenti di visualizzare e
gestire tutti i tuoi file di Drive. Per scoprire di più su
Ambiti Drive, consulta Scegliere l'API Google Drive
ambiti.
Nell'esempio di codice viene dichiarato anche il tipo MIME di esportazione come application/pdf
. Per un
elenco completo di tutti i tipi MIME di esportazione supportati per ogni Google Workspace
consulta l'articolo Esportare i tipi MIME per Google Workspace
documenti.
Esportare 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 la
exportLinks
del
files
. In base al documento
, per ogni tipo MIME viene restituito un link per scaricare il file e i suoi contenuti
tipo disponibile. Puoi reindirizzare un utente a un URL o offrirlo come URL
cliccabile.
Esportare i contenuti dei documenti di Google Workspace in una versione precedente in un browser
Per esportare i contenuti di un documento 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 ha
l'accesso in download al file, viene fornito un link per scaricare il file e i suoi contenuti
restituito. Puoi reindirizzare un utente a questo URL o offrirlo come URL cliccabile
.