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 sont les suivants:

  • Adresse e-mail du contact API Google Ads: il s'agit de l'adresse e-mail du contact dans le centre 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.
  • Adresse e-mail du ou des comptes administrateur Google Ads: il s'agit des adresses e-mail disposant d'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 d'une équipe changent d'équipe ou quittent l'entreprise. Le reste de ce guide détaille chacun des e-mails répertoriés précédemment et explique comment le mettre à jour pour utiliser un alias d'équipe partagé plutôt que l'adresse e-mail d'un utilisateur individuel.

Adresse e-mail du contact pour l'API Google Ads

Il s'agit de l'adresse e-mail que vous avez indiquée lors de votre inscription à l'API Google Ads. Vous devez garantir l'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 l'ensemble de l'équipe reçoit ces notifications.

Pour modifier l'adresse e-mail du contact API:

  • Connectez-vous au compte administrateur Google Ads que vous avez utilisé pour demander l'accès à l'API Google Ads. Il s'agit du compte où se trouve votre jeton de développeur.
  • Accédez à Outils et paramètres > Centre API.
  • Cliquez sur la flèche sous la section Adresse e-mail du contact de l'API.
  • Modifiez l'adresse e-mail, puis cliquez sur le bouton Enregistrer.

Compte de la console Google Cloud

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 créant un alias partagé comme propriétaire du compte.

Suivez ces étapes pour mettre à jour 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 situé dans l'angle supérieur gauche de la page.
  • Dans le menu de gauche, accédez à IAM and admin > IAM (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 Save (Enregistrer). Reportez-vous à la documentation Cloud pour savoir comment accorder et révoquer des accès.

compte administrateur Google Ads

Pour gérer les comptes à l'aide de l'API Google Ads, une méthode courante consiste à associer tous vos comptes à un même compte administrateur et à appeler l'API pour tous les comptes à l'aide des identifiants du compte administrateur de niveau supérieur. 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 le numéro client du compte administrateur Google Ads et l'en-tête customer_id comme le numéro client du compte vers lequel les appels d'API sont effectués.

Cette configuration présente un risque potentiel : si l'utilisateur autorisé perd l'accès au compte administrateur Google Ads, le jeton d'actualisation ne sera plus valide et tous les appels d'API échoueront. Pour éviter ce scénario, vous pouvez inviter un alias d'adresse e-mail partagé à gérer ce compte administrateur Google Ads en lui accordant les niveaux d'accès appropriés. Utilisez cet alias d'adresse e-mail partagé pour émettre le jeton d'actualisation pour effectuer des appels d'API.