Alias partagés

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 pour l'API Google Ads : il s'agit de l'adresse e-mail indiquée comme contact dans le centre d'API de l'UI Google Ads.
• Adresse e-mail du compte de la console Google Cloud : il s'agit de l'adresse e-mail qui dispose d'un accès administrateur au compte de la console Google Cloud utilisé pour votre application OAuth 2.0.
• Adresse(s) e-mail du compte administrateur Google Ads : il s'agit des adresses e-mail disposant des autorisations d'administrateur sur le ou les comptes administrateur Google Ads auxquels vous accédez via l'API Google Ads. Lorsque vous générez un jeton d'actualisation pour votre application, vous authentifiez généralement votre application API Google Ads avec l'une de ces adresses e-mail.

Nous vous recommandons vivement d'utiliser des alias d'équipe partagés afin de ne pas perdre l'accès à ces comptes lorsque des membres de l'équipe changent d'équipe ou quittent l'entreprise. Le reste de ce guide détaille chacun des e-mails listés précédemment et explique comment les modifier pour utiliser un alias d'équipe partagé au lieu de l'adresse e-mail d'un utilisateur individuel.

Adresse e-mail de contact de l'API Google Ads

L'adresse e-mail de contact pour l'API Google Ads est celle que vous fournissez lorsque vous vous inscrivez à l'API Google Ads. Vous devez vous assurer d'avoir accès à cet alias et surveiller régulièrement les e-mails envoyés à cette adresse. Google utilise cette adresse e-mail pour contacter votre équipe lors des examens d'API, des demandes d'audit ou des urgences de production nécessitant une attention immédiate. Utilisez un alias d'équipe partagé comme adresse e-mail de contact pour vous assurer que toute l'équipe reçoit ces notifications.

Pour modifier l'adresse e-mail de contact de l'API, procédez comme suit :

1. Connectez-vous à votre compte administrateur Google Ads.

2. Cliquez sur Admin (Administration) en bas à gauche de l'écran.

3. Sous Paramètres du compte administrateur, cliquez sur Centre d'API.

4. Sous Informations sur le développeur, notez l'adresse e-mail de contact de l'API. Cliquez sur la flèche vers le bas et modifiez l'e-mail. Cliquez sur Enregistrer.

Compte Google Cloud Console

Le projet de la console Google APIs contient les identifiants OAuth de votre application et contrôle l'accès à l'API Google Ads. Assurez-vous d'avoir accès à ce compte en faisant du titulaire du compte un alias partagé.

Pour modifier le propriétaire du projet dans la console Google APIs, procédez comme suit :

• Connectez-vous à la console Google APIs.
• Sélectionnez votre projet dans le menu déroulant en haut à gauche de la page.
• Dans le menu de gauche, accédez à IAM et administration > IAM.
• Cliquez sur le bouton Accorder l'accès.
• Saisissez l'adresse e-mail partagée dans la section Ajouter des comptes principaux.
• Attribuez le rôle Propriétaire.
• Cliquez sur le bouton Enregistrer. Pour en savoir plus sur l'attribution et la révocation des accès, consultez la documentation Cloud.

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 à tous les comptes à l'aide des identifiants du compte administrateur de premier niveau. Dans cette configuration :

• Le développeur émet un jeton d'actualisation à l'aide des identifiants d'un utilisateur ayant accès au compte administrateur Google Ads.
• Le développeur définit l'en-tête login_customer_id comme ID client du compte administrateur Google Ads et l'en-tête customer_id comme ID client du compte auquel les appels d'API sont effectués.

L'un des risques potentiels de cette configuration est que si l'utilisateur autorisé perd l'accès au compte administrateur Google Ads, le jeton d'actualisation n'est plus valide et tous les appels d'API échouent. Pour éviter ce scénario, vous pouvez inviter un alias d'adresse e-mail partagé à gérer ce compte administrateur Google Ads avec les niveaux d'accès appropriés. Utilisez cet alias d'adresse e-mail partagé pour émettre le jeton d'actualisation permettant d'effectuer des appels d'API.