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, les plus importants étant les suivants:

  • Adresse e-mail du contact de l'API Google Ads: il s'agit de l'adresse e-mail indiquée comme contact dans le centre des API de l'interface utilisateur Google Ads.
  • Adresse e-mail du compte de la console Google Cloud: il s'agit de l'adresse e-mail disposant d'un accès administrateur au compte de la console Google Cloud utilisé pour votre application OAuth 2.0.
  • Adresses e-mail du ou des comptes 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 d'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 explique chacun des e-mails listés précédemment et 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 de 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 d'examens d'API, de demandes d'audit ou d'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 Administration en bas à gauche de l'écran.

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

  4. Sous Détails du 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 désignant un alias partagé comme propriétaire du compte.

Pour modifier le propriétaire du projet de la console Google APIs:

  • Connectez-vous à la console Google APIs.
  • Sélectionnez votre projet dans le menu déroulant en haut à gauche de la page.
  • Accédez à IAM et administration > IAM dans le menu de gauche.
  • 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'octroi et la révocation des accès, consultez la documentation Cloud.

compte administrateur Google Ads

Une méthode courante pour gérer 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 le plus élevé. 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 numéro client du compte administrateur Google Ads et l'en-tête customer_id comme numéro client du compte auquel des appels d'API sont effectués.

Un risque potentiel 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.