L'API Google Drive est compatible avec plusieurs types d'actions de téléchargement et d'exportation : répertoriés 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 télécharger le
à l'aide du champ capabilities.canDownload
du
Ressource files
.
Le reste de ce guide fournit des instructions détaillées pour effectuer ces types 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 réponse alternative
.
Le paramètre d'URL alt=media
est un système
dans toutes les API REST de Google. Si vous utilisez une bibliothèque cliente
l'API Drive, vous n'avez pas besoin de définir ce paramètre explicitement.
L'exemple de code suivant montre comment utiliser la méthode files.get
pour télécharger un
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 depuis votre application doivent être autorisés avec un champ d'application qui autorise
un accès en lecture
au contenu du fichier. Par exemple, une application utilisant
Le niveau d'accès de drive.readonly.metadata
n'est pas autorisé à télécharger le contenu du fichier.
Cet exemple de code utilise le champ d'application de fichier restreint "drive" qui permet aux utilisateurs de
afficher et gérer tous vos fichiers Drive. Pour en savoir plus sur
Pour les champs d'application Drive, consultez Choisir l'API Google Drive
champs d'application.
Les utilisateurs disposant de droits de modification peuvent limiter le téléchargement par les utilisateurs en lecture seule via
en configurant copyRequiresWriterPermission
sur false
.
Fichiers identifiés comme
abusif
(comme les logiciels malveillants) ne peuvent être téléchargés que par le propriétaire du fichier.
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
les logiciels indésirables ou autres fichiers abusifs. Votre application doit être interactive
avant d'utiliser ce paramètre de requête.
Téléchargement partiel
Le téléchargement partiel n'implique que le téléchargement d'une partie spécifique d'un fichier. Toi
vous pouvez spécifier la partie du fichier à télécharger à l'aide d'une valeur
plage
avec l'en-tête Range
. Exemple :
Range: bytes=500-999
Télécharger le contenu du fichier blob à une version antérieure
Pour télécharger le contenu de fichiers blob à une version antérieure, utilisez la classe
Méthode revisions.get
avec l'ID de
le 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
demandé en tant que
format de réponse alternatif. Semblable à files.get
, le
La méthode revisions.get
accepte aussi le paramètre de requête facultatif
acknowledgeAbuse
et l'en-tête Range
. Pour en savoir plus sur le téléchargement
révisions, consultez la section Télécharger et publier des
révisions.
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
au lieu de passer par l'API, utilisez le
Champ webContentLink
de
Ressource files
. Si l'utilisateur a téléchargé
au fichier, un lien pour télécharger le fichier et son contenu est
renvoyé. Vous pouvez rediriger l'utilisateur vers cette URL ou la proposer sous forme
.
Exporter le contenu de documents Google Workspace
Pour exporter le contenu d'octets du document Google Workspace, utilisez la méthode files.export
avec l'ID du fichier à exporter
et le type MIME approprié. Exportées
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 du client API Drive
bibliothèques:
Java
Python
Node.js
PHP
.NET
Cet exemple de code utilise le champ d'application drive
restreint qui permet aux utilisateurs d'afficher et
gérer tous vos fichiers Drive. Pour en savoir plus sur
Pour les champs d'application Drive, consultez Choisir l'API Google Drive
champs d'application.
L'exemple de code déclare également le type MIME d'exportation comme application/pdf
. Pour une
la liste complète de tous les types MIME d'exportation compatibles avec chaque service Google Workspace ;
consultez Exporter les types MIME pour Google Workspace
documents.
Exporter le contenu de documents Google Workspace dans un navigateur
Pour exporter le contenu de documents Google Workspace dans un navigateur, utilisez le
Champ exportLinks
de
Ressource files
. Selon le document
, un lien pour télécharger le fichier et son contenu est renvoyé pour chaque
est disponible. Vous pouvez soit rediriger un utilisateur vers une URL, soit lui proposer
lien cliquable.
Exporter le contenu d'un document Google Workspace à une version antérieure dans un navigateur
Pour exporter le contenu d'un document Google Workspace à une version antérieure d'un
utilisez la méthode revisions.get
avec l'ID du fichier à télécharger et l'ID de la révision. Si l'utilisateur a
télécharger l'accès au fichier, un lien pour télécharger le fichier et son contenu est
renvoyé. Vous pouvez rediriger l'utilisateur vers cette URL ou la proposer sous forme
.