Dissociation du consentement dans les API Ads

Jeudi 20 février 2025

Qu'est-ce qui change ?
À partir de la semaine du 1er mai 2025, nous déploierons la dissociation du consentement pour l'authentification des utilisateurs OAuth sur tous les projets Google Cloud créés avant 2019. Si vous possédez une application qui utilise une API liée à Ads via un projet Google Cloud créé avant 2019, vous devrez peut-être la mettre à jour pour gérer le consentement utilisateur dissocié avant le 1er mai 2025.

Contexte
La dissociation du consentement pour le flux d'authentification des utilisateurs OAuth permet aux utilisateurs de personnaliser les habilitations OAuth spécifiques qu'ils souhaitent autoriser pour votre application, plutôt que d'adopter une approche de type "tout ou rien". Cette fonctionnalité est activée pour tous les projets de la console Google Cloud créés depuis 2019, mais désactivée pour tous les projets créés avant 2019.

Qui est concerné par ce changement ?
Vous serez concerné par ce changement si TOUTES les conditions suivantes sont remplies :

  1. Votre application API utilise un projet de la console Google Cloud créé avant 2019.
  2. Votre application implémente le flux de consentement utilisateur OAuth 2.0, un workflow d'authentification dans lequel l'utilisateur se connecte avec son compte Google et accorde une ou plusieurs autorisations demandées par votre application.
  3. Votre application utilise plusieurs API Google, et l'une d'elles est une API liée aux annonces listée ci-dessous.

Qui n'est pas concerné par ce changement ?

  • Jetons d'actualisation existants : ce changement n'affecte pas les authentifications utilisateur que vous avez déjà mises en place. Vos jetons d'actualisation existants continueront de fonctionner sans modification ni nouvelle authentification.
  • Applications à champ d'application unique : si votre application n'utilise qu'un seul champ d'application d'API Google, elle n'est pas concernée par ce changement, car il n'y a pas plusieurs champs d'application OAuth à dissocier.
  • Applications mono-utilisateur/Applications authentifiées manuellement : votre application n'implémente pas de flux d'authentification utilisateur OAuth explicite. À la place, vous utilisez un script d'authentification manuelle tel que GenerateUserCredentials, la gcloud CLI ou OAuth Playground pour authentifier l'utilisateur, puis vous utilisez ces identifiants pendant une longue période. Étant donné que vous sélectionnez tous les champs d'application requis par votre application lors de l'authentification, votre application n'est pas concernée par ce changement.
  • Comptes de service : si votre application utilise un compte de service pour authentifier vos appels d'API, vous ne serez pas concerné par ce changement.

Que dois-je faire ?
Vous devez vous assurer que votre application peut gérer le consentement utilisateur partiel. Pour cela,

  1. Demandez la liste des champs d'application OAuth que l'utilisateur a acceptés en incluant le paramètre include_granted_scopes dans votre flux OAuth.
  2. Examinez la liste réelle des champs d'application OAuth que l'utilisateur a acceptés dans la réponse OAuth.
  3. Implémentez l'autorisation incrémentielle dans votre application.

Consultez notre guide sur le consentement granulaire OAuth pour connaître les exigences et les bonnes pratiques à suivre pour gérer le consentement granulaire.

Comment tester cette fonctionnalité ?
Il existe deux façons de tester cette fonctionnalité :

  1. Créer un projet Google Cloud : les nouveaux projets Google Cloud ont activé la dissociation du consentement OAuth. Vous pouvez donc créer un projet Google Cloud et l'utiliser pour tester votre application.
  2. Activer la dissociation du consentement dans votre projet existant : vous pouvez définir le paramètre enable_granular_consent sur "true" dans votre demande d'autorisation OAuth.

Quels sont les champs d'application d'API concernés ?
Les API suivantes liées à Ads sont concernées par ce changement.

API Habilitation OAuth
L'API Google Ads https://adwords.google.com/api/adwords
API Google Ad Manager (API SOAP, bêta) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
API Bid Manager https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
API Display & Video 360 https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
API AdMob https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
API AdSense pour les plates-formes https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
API Google Analytics https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.manage.users
https://www.googleapis.com/auth/analytics.manage.users.readonly
https://www.googleapis.com/auth/analytics.provision
https://www.googleapis.com/auth/analytics.user.deletion
API Campaign Manager 360 https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
API Search Ads 360 https://www.googleapis.com/auth/doubleclicksearch
API Google Tag Manager https://www.googleapis.com/auth/tagmanager.delete.containers
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.manage.accounts
https://www.googleapis.com/auth/tagmanager.manage.users
https://www.googleapis.com/auth/tagmanager.publish
https://www.googleapis.com/auth/tagmanager.readonly
API Real-time Bidding https://www.googleapis.com/auth/realtime-bidding
API Marketplace Authorized Buyers https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

Comment obtenir de l'aide
Si vous avez des questions ou si vous avez besoin d'aide, contactez l'équipe d'assistance de l'API concernée.

Portrait de l'auteur - , équipe API Google Ads

Étiquettes : authentification, oauth