Lorsque vous utilisez l'API Google Ads, les adresses e-mail sont utilisées à plusieurs endroits pour la gestion des contacts et des accès. Voici les plus importants :
- Adresse e-mail de contact de l'API Google Ads : adresses e-mail auxquelles est attribué le rôle Propriétaire ou Éditeur dans votre projet Google Cloud, que Google utilise pour envoyer des annonces obligatoires sur le service et des notifications administratives.
- Adresse e-mail du compte de la console Google Cloud : adresse e-mail disposant d'un accès administrateur au projet Google Cloud utilisé pour votre application OAuth 2.0.
- Accès au compte administrateur Google Ads : compte de service (recommandé) ou alias d'adresse e-mail partagé disposant d'autorisations d'accès au(x) compte(s) administrateur Google Ads accessible(s) via l'API Google Ads.
Le reste de ce guide détaille chacun des comptes listés précédemment et explique comment les configurer pour que votre intégration ne dépende pas de l'adresse e-mail d'un utilisateur individuel.
Adresse e-mail de contact pour l'API Google Ads
Google envoie des notifications administratives, des informations sur l'examen de l'API, des demandes d'audit, des annonces obligatoires sur le service et des communications d'urgence concernant la production aux adresses e-mail associées aux rôles Propriétaire et Éditeur de votre projet Google Cloud (voir Nouvelles adresses e-mail de contact pour l'API, car l'ancien paramètre d'adresse e-mail de contact du centre d'API dans l'interface utilisateur de Google Ads a été abandonné).
Pour mettre à jour votre adresse e-mail de contact et vous assurer que toute votre équipe reçoit ces notifications, attribuez le rôle Propriétaire ou Éditeur à un alias d'équipe partagé dans votre projet Google Cloud et surveillez régulièrement les e-mails envoyés à cet alias.
Compte de la console Google Cloud
Le projet de la console Google Cloud contient les identifiants OAuth de votre application et contrôle l'accès à l'API Google Ads. Assurez l'accès à ce projet en attribuant le rôle Propriétaire (ou Éditeur) à un alias d'équipe partagé.
Pour ajouter un alias partagé en tant que propriétaire d'un projet Google Cloud, procédez comme suit :
- Connectez-vous à la console Google Cloud.
- Sélectionnez votre projet dans le sélecteur de projets en haut de la page.
- Dans le menu de navigation, accédez à IAM et administration > IAM.
- Cliquez sur Accorder l'accès.
- Dans la section Ajouter des comptes principaux, saisissez l'adresse e-mail partagée dans le champ Nouveaux comptes principaux.
- Dans la section Attribuer des rôles, cliquez sur Sélectionner un rôle, puis sélectionnez De base > Propriétaire (ou De base > Éditeur).
- Cliquez sur Enregistrer. Si vous avez attribué le rôle Propriétaire à une adresse e-mail en dehors de votre organisation Google Cloud (ou sur un projet sans organisation), Google Cloud envoie un e-mail d'invitation à l'alias partagé, qui doit être accepté avant que le rôle ne prenne effet. Consultez la documentation Cloud pour savoir comment accorder et révoquer l'accès.
compte administrateur Google Ads
Une méthode courante de gestion des comptes à l'aide de l'API Google Ads consiste à associer tous vos comptes à un compte administrateur commun et à effectuer des appels d'API vers tous les comptes à l'aide des identifiants du compte administrateur de niveau supérieur. Dans cette configuration, le développeur définit l'en-tête de requête login-customer-id (ou le paramètre de configuration de la bibliothèque cliente login_customer_id) sur le numéro client à 10 chiffres (sans tirets) du compte administrateur Google Ads, et définit le customer_id cible sur le compte opérationnel auquel les appels d'API sont effectués.
Recommandé : Utiliser un compte de service
L'utilisation d'un compte de service est la méthode privilégiée pour authentifier un compte administrateur Google Ads et y accéder. Contrairement aux comptes utilisateur individuels, un compte de service est géré dans votre projet Google Cloud et n'est pas lié à une personne spécifique. Cela permet d'éviter les interruptions de service lorsque les membres de l'équipe changent de rôle ou quittent l'entreprise. Suivez le guide sur les comptes de service pour créer un compte de service et lui accorder l'accès à votre compte administrateur Google Ads.
Alternative : utiliser un alias d'adresse e-mail partagé
Si votre intégration ne peut pas utiliser de compte de service et repose plutôt sur le workflow d'authentification d'un seul utilisateur, un utilisateur ayant accès au compte administrateur Google Ads émet un jeton d'actualisation OAuth 2.0.
Pour éviter ce scénario lorsque vous utilisez des identifiants utilisateur :
- Invitez un alias d'adresse e-mail partagé (associé à un compte Google actif pour lequel la validation par clé d'accès est activée) à gérer ce compte administrateur Google Ads avec les niveaux d'accès appropriés.
- Acceptez l'invitation à l'aide de l'alias d'adresse e-mail partagé.
- Utilisez cet alias d'adresse e-mail partagé pour émettre le jeton d'actualisation OAuth permettant d'effectuer des appels d'API.