L'API Google Drive est compatible avec plusieurs types d'actions de téléchargement et d'exportation, comme indiqué dans le tableau suivant:
Téléchargements |
|
|||
Exportations |
|
Avant de télécharger ou d'exporter le contenu d'un fichier, vérifiez que les utilisateurs peuvent le télécharger à l'aide du champ capabilities.canDownload
de la ressource files
.
Le reste de ce guide fournit des instructions détaillées pour effectuer ces types d'actions de téléchargement et d'exportation.
Télécharger le contenu du fichier blob
Pour télécharger un fichier blob stocké dans Drive, utilisez la méthode files.get
avec l'ID du fichier à télécharger et le paramètre d'URL alt=media
. Le paramètre d'URL alt=media
indique au serveur qu'un téléchargement de contenu est demandé en tant que format de réponse alternatif.
Le paramètre d'URL alt=media
est un paramètre système disponible dans toutes les API REST de Google. Si vous utilisez une bibliothèque cliente pour l'API Drive, vous n'avez pas besoin de définir explicitement ce paramètre.
L'exemple de code suivant montre comment utiliser la méthode files.get
pour télécharger un fichier avec les bibliothèques clientes de l'API Drive.
Java
Python
Node.js
PHP
.NET
Cet exemple de code utilise une méthode de bibliothèque qui ajoute le paramètre d'URL alt=media
à la requête HTTP sous-jacente.
Les téléchargements de fichiers démarrés à partir de votre application doivent être autorisés avec un champ d'application autorisant l'accès en lecture au contenu des fichiers. Par exemple, une application utilisant le champ d'application drive.readonly.metadata
n'est pas autorisée à télécharger le contenu du fichier.
Cet exemple de code utilise le champ d'application restreint "drive" qui permet aux utilisateurs d'afficher et de gérer tous vos fichiers Drive. Pour en savoir plus sur les champs d'application de Drive, consultez Choisir les champs d'application de l'API Google Drive.
Les utilisateurs disposant de droits de modification peuvent restreindre le téléchargement par des utilisateurs en lecture seule en définissant le champ copyRequiresWriterPermission
sur false
.
Les fichiers identifiés comme abus (par exemple, les logiciels malveillants) ne peuvent être téléchargés que par leur propriétaire.
En outre, le paramètre de requête get
(acknowledgeAbuse=true
) doit être inclus pour indiquer que l'utilisateur a pris connaissance du risque de téléchargement de logiciels potentiellement indésirables ou d'autres fichiers abusifs. Votre application doit alerter l'utilisateur de manière interactive avant d'utiliser ce paramètre de requête.
Téléchargement partiel
Un téléchargement partiel consiste à ne télécharger qu'une partie spécifique d'un fichier. Vous pouvez spécifier la partie du fichier que vous souhaitez télécharger en utilisant une plage d'octets avec l'en-tête Range
. Exemple :
Range: bytes=500-999
Télécharger le contenu d'un fichier blob à une version antérieure
Pour télécharger le contenu de fichiers blob dans une version antérieure, utilisez la méthode revisions.get
avec l'ID du fichier à télécharger, l'ID de la révision et le paramètre d'URL alt=media
.
Le paramètre d'URL alt=media
indique au serveur qu'un téléchargement de contenu est demandé en tant que format de réponse alternatif. Comme pour files.get
, la méthode revisions.get
accepte également le paramètre de requête facultatif acknowledgeAbuse
et l'en-tête Range
. Pour en savoir plus sur le téléchargement de révisions, consultez Télécharger et publier des révisions de fichiers.
Télécharger le contenu d'un fichier blob dans un navigateur
Pour télécharger le contenu des fichiers blob stockés sur Drive dans un navigateur (plutôt que via l'API), utilisez le champ webContentLink
de la ressource files
. Si l'utilisateur dispose d'un accès en téléchargement, un lien permettant de télécharger le fichier et son contenu est renvoyé. Vous pouvez rediriger un utilisateur vers cette URL ou la proposer en tant que lien cliquable.
Exporter le contenu d'un document Google Workspace
Pour exporter le contenu octet d'un document Google Workspace, utilisez la méthode files.export
avec l'ID du fichier à exporter et le type MIME approprié. Le contenu exporté est limité à 10 Mo.
L'exemple de code suivant montre comment utiliser la méthode files.export
pour exporter un document Google Workspace au format PDF à l'aide des bibliothèques clientes de l'API Drive:
Java
Python
Node.js
PHP
.NET
Cet exemple de code utilise le champ d'application restreint drive
qui permet aux utilisateurs d'afficher et de gérer tous vos fichiers Drive. Pour en savoir plus sur les champs d'application de Drive, consultez Choisir les champs d'application de l'API Google Drive.
L'exemple de code déclare également le type MIME pour l'exportation comme application/pdf
. Pour obtenir la liste complète de tous les types MIME d'exportation compatibles avec chaque document Google Workspace, consultez Exporter des types MIME pour les documents Google Workspace.
Exporter le contenu d'un document Google Workspace dans un navigateur
Pour exporter le contenu d'un document Google Workspace dans un navigateur, utilisez le champ exportLinks
de la ressource files
. Selon le type de document, un lien permettant de télécharger le fichier et son contenu est renvoyé pour chaque type MIME disponible. Vous pouvez rediriger un utilisateur vers une URL ou la proposer en tant que lien cliquable.
Exportez le contenu d'un document Google Workspace dans un navigateur, dans une version antérieure
Pour exporter le contenu d'un document Google Workspace dans une version antérieure dans un navigateur, utilisez la méthode revisions.get
avec l'ID du fichier à télécharger et l'ID de la révision. Si l'utilisateur dispose d'un accès en téléchargement, un lien permettant de télécharger le fichier et son contenu est renvoyé. Vous pouvez rediriger un utilisateur vers cette URL ou la proposer en tant que lien cliquable.