Alias partagés

Lorsque vous utilisez l'API Google Ads, les adresses e-mail sont utilisées à plusieurs reprises pour la gestion des contacts et des accès. Les plus importantes sont les suivantes:

• Adresse e-mail du contact pour l'API Google Ads: il s'agit de l'adresse e-mail indiquée dans le centre API de l'interface utilisateur Google Ads.
• Adresse e-mail du compte Google Cloud Console: il s'agit de l'adresse e-mail disposant d'un accès administrateur au compte Google Cloud Console 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 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 celle-ci avec l'une de ces adresses e-mail.

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

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

L'adresse e-mail de contact pour l'API Google Ads est une adresse e-mail que vous fournissez 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 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 associée à l'API, procédez comme suit:

• 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 dans lequel 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 de 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. Pour assurer l'accès à ce compte, définissez un alias partagé en tant que titulaire du compte.

Pour mettre à jour le propriétaire du projet de 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.
• 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 Save (Enregistrer). Consultez la documentation Cloud pour savoir comment accorder et révoquer un accès.

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 vers 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 numéro client du compte administrateur Google Ads et l'en-tête customer_id comme numéro 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 cela, 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.