L'API Google Drive accepte plusieurs types d'actions de téléchargement et d'exportation, comme indiqué dans le tableau suivant:
Téléchargements |
|
|||
Exportations |
|
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é sur 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 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 lancé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 Drive, consultez les informations d'authentification et d'authentification spécifiques aux API.
Les utilisateurs disposant d'autorisations de modification peuvent limiter le téléchargement aux utilisateurs en lecture seule en définissant le champ copyRequiresWriterPermission
sur false
.
Les fichiers identifiés comme abusifs (tels que les logiciels nuisibles) 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 indésirables ou d'autres fichiers abusifs. Votre application doit avertir l'utilisateur de manière interactive avant d'utiliser ce paramètre de requête.
Téléchargement partiel
Le téléchargement partiel implique le téléchargement d'une partie spécifique d'un fichier. Vous pouvez spécifier la partie du fichier que vous souhaitez télécharger à l'aide d'une plage d'octets avec l'en-tête Range
. Exemple :
Range: bytes=500-999
Télécharger le contenu du fichier blob d'une version antérieure
Pour télécharger le contenu de fichiers blob d'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 des révisions, consultez la page Télécharger et publier des révisions de fichiers.
Télécharger le contenu du 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 au téléchargement, un lien pour télécharger le fichier et son contenu est renvoyé. Vous pouvez rediriger un utilisateur vers cette URL ou lui proposer un lien cliquable.
Exporter le contenu des documents Google Workspace
Pour exporter le contenu de l'octet du 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 Drive, consultez les informations d'authentification et d'authentification spécifiques aux API.
L'exemple de code déclare également que le type MIME d'exportation est application/pdf
. Pour obtenir la liste complète des types MIME d'exportation acceptés pour chaque document Google Workspace, consultez Exporter les 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 pour télécharger le fichier et son contenu est renvoyé pour chaque type MIME disponible. Vous pouvez rediriger un utilisateur vers une URL ou lui proposer un lien cliquable.
Exporter une version antérieure d'un document Google Workspace dans un navigateur
Pour exporter le contenu d'un document Google Workspace dans une version antérieure d'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 au téléchargement, un lien pour télécharger le fichier et son contenu est renvoyé. Vous pouvez rediriger un utilisateur vers cette URL ou lui proposer un lien cliquable.