Pour configurer OAuth pour votre application, vous devez configurer un workflow OAuth et activer les champs d'application OAuth de l'API Data Portability.
Configurer un workflow OAuth
Pour configurer un flux OAuth pour votre application, suivez les étapes de base décrites dans la documentation de Google Identity.
La plupart des développeurs utilisent le flux des applications Web côté serveur pour obtenir le consentement OAuth, mais vous pouvez également utiliser le flux d'applications Web JavaScript ou le flux applications mobiles et de bureau.
Champs d'application OAuth de l'API Data Portability
Lorsque vous configurez votre application d'API Data Portability pour OAuth, activez les champs d'application OAuth pertinents pour cette API. Pour obtenir la liste de tous les champs d'application OAuth compatibles avec l'API Data Portability, consultez la page Champs d'application OAuth 2.0 pour les API Google. Pour obtenir la liste de tous les groupes de ressources et de tous les champs d'application OAuth compatibles avec un service particulier, consultez la page de référence du schéma de ce service.
Lorsque vous ajoutez les champs d'application de l'API Data Portability à votre flux OAuth, il peut arriver que l'utilisateur donne son consentement pour certains d'entre eux, mais pas tous. Votre application doit pouvoir gérer ces cas de figure:
- Autoriser les exportations partielles de données
- Notification à l'utilisateur qu'il n'a pas sélectionné tous les champs d'application nécessaires (et échec en douceur)
- Demander à l'utilisateur les autorisations restantes
Notez que le consentement d'un utilisateur vous permet d'exporter des données pour ce consentement spécifique. Pour télécharger à nouveau les données, vous devez obtenir un nouveau consentement de l'utilisateur.
Notez également que pendant le flux OAuth, votre application ne sait pas quel compte Google a été utilisé pour donner son consentement. Le jeton OAuth reçu par votre application est opaque.
Pour savoir comment les utilisateurs partagent des données, consultez Partager une copie de vos données avec un tiers.