Ce document contient des informations d'autorisation et d'authentification spécifiques à l'API Google Drive. Avant de lire ce document, veillez à lire les informations générales d'authentification et d'autorisation de Google Workspace sur la page En savoir plus sur l'authentification et l'autorisation.
Configurer OAuth 2.0 pour l'autorisation
Configurez l'écran de consentement OAuth et choisissez des autorisations pour définir les informations qui s'affichent auprès des utilisateurs et des examinateurs de l'application, et enregistrez votre application pour pouvoir la publier ultérieurement.
Champs d'application des API Drive
Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des champs d'application de l'autorisation. Un champ d'application est une chaîne d'URI OAuth 2.0 qui contient le nom de l'application Google Workspace, le type de données auxquelles elle accède et le niveau d'accès. Les champs d'application correspondent aux demandes de votre application pour utiliser les données Google Workspace, y compris les données du compte Google des utilisateurs.
Lorsque votre application est installée, un utilisateur est invité à valider les champs d'application utilisés par l'application. En règle générale, vous devez choisir le champ d'application le plus ciblé possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des champs d'application limités et clairement décrits.
Lorsque cela est possible, nous vous recommandons d'utiliser des portées non sensibles, car elles accordent une portée d'accès par fichier et limitent l'accès aux fonctionnalités spécifiques requises par une application.
L'API Drive est compatible avec les champs d'application suivants:
| Code de champ d'application | Description | Utilisation |
|---|---|---|
https://www.googleapis.com/auth/drive.appdata |
Consultez et gérez les données de configuration de l'application dans Google Drive. | Recommandé Non sensible |
https://www.googleapis.com/auth/drive.install |
Autorisez les applications à apparaître en tant qu'option dans le menu "Ouvrir avec" ou "Nouveau". | Recommandé Non sensible |
https://www.googleapis.com/auth/drive.file |
Créez des fichiers Drive ou modifiez des fichiers existants que vous ouvrez avec une application ou que l'utilisateur partage avec une application à l'aide de l'API Google Picker ou du sélecteur de fichiers de l'application. | Recommandé Non sensible |
https://www.googleapis.com/auth/drive.apps.readonly |
Affichez les applications autorisées à accéder à votre Drive. | Contenu à caractère sensible |
https://www.googleapis.com/auth/drive |
Afficher et gérer tous vos fichiers Drive | Limité |
https://www.googleapis.com/auth/drive.readonly |
Consultez et téléchargez tous vos fichiers Drive. | Limité |
https://www.googleapis.com/auth/drive.activity |
Afficher le journal d'activités des fichiers de votre Drive et y ajouter des éléments | Limité |
https://www.googleapis.com/auth/drive.activity.readonly |
Afficher le journal d'activités des fichiers de votre Drive | Limité |
https://www.googleapis.com/auth/drive.meet.readonly |
afficher les fichiers Drive créés ou modifiés dans Google Meet ; | Limité |
https://www.googleapis.com/auth/drive.metadata |
Afficher et gérer les métadonnées des fichiers présents dans votre Drive | Limité |
https://www.googleapis.com/auth/drive.metadata.readonly |
Consultez les métadonnées de vos fichiers dans Drive. | Limité |
https://www.googleapis.com/auth/drive.scripts |
Modifiez le comportement de vos scripts Google Apps Script. | Limité |
La colonne "Utilisation" du tableau ci-dessus indique la sensibilité de chaque champ d'application, conformément aux définitions suivantes:
Recommandé / Non sensible: ces champs d'application offrent le champ d'application d'autorisation le plus restreint et ne nécessitent qu'une validation de base de l'application. Pour en savoir plus sur cette exigence, consultez la section Exigences liées à la validation.
Recommandé / Sensible: ces champs d'application donnent accès à des données utilisateur Google spécifiques autorisées par l'utilisateur pour votre application. Vous devez effectuer une validation supplémentaire de l'application. Pour en savoir plus sur cette exigence, consultez la section Exigences concernant le champ d'application sensible et restreint.
Restreints: ces champs d'application offrent un accès étendu aux données utilisateur Google et vous devez suivre une procédure de validation de champ d'application restreint. Pour en savoir plus sur cette exigence, consultez les Règles sur les données utilisateur dans les services des API Google et les Exigences supplémentaires pour les champs d'application d'API spécifiques. Si vous stockez (ou transmettez) des données à portée limitée sur des serveurs, vous devez procéder à une évaluation de la sécurité.
Si votre application nécessite l'accès à d'autres API Google, vous pouvez également ajouter ces champs d'application. Pour en savoir plus sur les champs d'application des API Google, consultez la section Utiliser OAuth 2.0 pour accéder aux API Google.
Pour en savoir plus sur des champs d'application OAuth 2.0 spécifiques, consultez la section Champs d'application OAuth 2.0 pour les API Google.
Validation OAuth
L'utilisation de certains champs d'application OAuth peut nécessiter que votre application passe par le Centre d'aide de la validation des applications OAuth. Consultez les questions fréquentes sur l'application OAuth pour déterminer quand votre application doit faire l'objet d'une validation et quel type de validation est requis. Consultez également les Conditions d'utilisation de Google Drive.
Quand utiliser un champ d'application limité ?
Pour Drive, seuls les types d'applications suivants peuvent accéder aux habilitations limitées:
- Applications Web et spécifiques à une plate-forme qui permettent une synchronisation locale ou une sauvegarde automatique des fichiers Drive des utilisateurs
- Applications de productivité et d'enseignement dont l'interface utilisateur peut impliquer une interaction avec des fichiers Drive (ou leurs métadonnées ou autorisations). Les applications de productivité incluent les applications de gestion des tâches, de prise de notes, de communication en groupe de travail et de collaboration en classe.
- Applications de reporting et de sécurité qui fournissent des insights sur la façon dont les fichiers sont partagés ou consultés par les utilisateurs ou les clients.
Pour continuer à utiliser des champs d'application restreints, vous devez préparer votre application à la validation des champs d'application restreints.
Migrer une application existante à partir de champs d'application restreints
Si vous avez développé une application Drive avec l'un des champs d'application restreints, nous vous recommandons de migrer votre application pour utiliser un niveau d'accès non sensible, car il accorde un niveau d'accès par fichier et limite l'accès aux fonctionnalités spécifiques requises par une application. De nombreuses applications fonctionnent avec un accès par fichier sans aucune modification. Si vous utilisez votre propre sélecteur de fichiers, nous vous recommandons de passer à l'API Google Picker, qui prend entièrement en charge différents champs d'application.
Avantages de l'habilitation OAuth drive.file
L'utilisation du champ d'application OAuth drive.file et de l'API Google Picker optimise à la fois l'expérience utilisateur et la sécurité de votre application.
Le champ d'application OAuth de drive.file permet aux utilisateurs de choisir les fichiers qu'ils souhaitent partager avec votre application. Ils ont ainsi davantage de contrôle et d'assurance que l'accès de votre application à leurs fichiers est limité et plus sécurisé. En revanche, exiger un accès étendu à tous les fichiers Drive peut décourager les utilisateurs d'interagir avec votre application. Voici quelques raisons d'utiliser la portée drive.file:
Facilité d'utilisation: le champ d'application
drive.filefonctionne avec toutes les ressources REST de l'API Drive, ce qui signifie que vous pouvez l'utiliser de la même manière que les champs d'application OAuth plus larges.Fonctionnalités: l'API Google Picker offre une interface semblable à celle de Drive. Cela comprend plusieurs affichages affichant des aperçus et des vignettes des fichiers Drive, ainsi qu'une fenêtre modale intégrée afin que les utilisateurs ne quittent jamais l'application principale.
Pratique: les applications peuvent appliquer des filtres à certains types de fichiers Drive (tels que Google Docs, Sheets et les photos) lorsqu'elles utilisent un filtre sur les fichiers Google Picker.
De plus, comme drive.file n'est pas sensible, il permet un processus de validation plus simplifié.
Enregistrer des jetons d'actualisation
Enregistrez les jetons d'actualisation dans un espace de stockage sécurisé et à long terme, et continuez à les utiliser tant qu'ils restent valides.