Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 :
Cliquez sur Admin (Administration) en bas à gauche de l'écran.
Sous Paramètres du compte administrateur, cliquez sur Centre d'API.
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 :
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eWhen working with the Google Ads API, ensure continuous access by using shared team aliases for contact, access management, and authentication purposes instead of individual user emails.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API contact email is used for crucial communications, update it to a shared alias to keep your team informed about API reviews, audit requests, and production emergencies.\u003c/p\u003e\n"],["\u003cp\u003eSafeguard your Google Cloud Console account by granting ownership to a shared team alias, ensuring access to your application's OAuth credentials and control over API access.\u003c/p\u003e\n"],["\u003cp\u003eFor managing multiple Google Ads accounts, link them under a manager account and grant access to a shared alias for refresh token generation and uninterrupted API functionality.\u003c/p\u003e\n"],["\u003cp\u003eRegularly monitor and update these email addresses and access levels to maintain seamless API operations and avoid disruptions caused by personnel changes.\u003c/p\u003e\n"]]],[],null,["# Shared aliases\n\nWhen working with the Google Ads API, there are multiple places where email addresses\nare used for contact and access management, the most important of which are the\nfollowing:\n\n- **Google Ads API contact email**: This is the email listed as the contact in the API Center of the Google Ads UI.\n- **Google Cloud Console account email**: This is the email that has administrator access to the Google Cloud Console account used for your OAuth 2.0 application.\n- **Google Ads manager account email(s)**: These are the emails that have administrator permissions on the manager Google Ads account(s) you access through the Google Ads API. When you generate a refresh token for your application, you usually authenticate your Google Ads API application with one of these emails.\n\nWe strongly recommend using shared team aliases so that you don't lose access to\nthese accounts when individual team members switch teams or leave the company.\nThe rest of this guide elaborates on each of the emails listed earlier and how\nyou can update it to use a shared team alias instead of an individual user's\nemail address.\n\nGoogle Ads API contact email\n----------------------------\n\nThe Google Ads API contact email is an email address you provide when signing up for\nthe Google Ads API. You should ensure access to this alias and monitor emails sent to\nthis address regularly. Google uses this email address to contact your team\nduring API reviews, audit requests, or production emergencies that require\nimmediate attention. Use a shared team alias as the contact email to ensure that\nthe whole team receives these notifications.\n\nFollow these steps to update the API contact email:\n\n1. Sign in to your Google Ads [Manager\n Account](//ads.google.com/home/tools/manager-accounts/).\n\n2. Click **Admin** at the bottom left of the screen.\n\n3. Under **Manager account settings** , click **API center**.\n\n4. Under **Developer details** , note the API contact email. Click the down arrow\n and edit the email. Click **Save**.\n\nGoogle Cloud Console account\n----------------------------\n\nThe **Google API Console** project contains your application's OAuth credentials\nand controls access to the Google Ads API. Ensure access to this account by making a\nshared alias the account owner.\n\nFollow these steps to update the Google API Console project's owner:\n\n- Sign in to [**Google API Console**](//console.developers.google.com).\n- Select your project from the drop-down menu on the top-left corner of the page.\n- Navigate to **IAM and admin \\\u003e IAM** from the left menu.\n- Click the **Grant Access** button.\n- Enter the shared email address under the **Add principals** section.\n- Assign the **Owner** role.\n- Click the **Save** button. Refer to the Cloud documentation to learn more about [granting and revoking access](//cloud.google.com/iam/docs/granting-changing-revoking-access#single-role).\n\nGoogle Ads manager account\n--------------------------\n\nA common method of managing accounts using the Google Ads API is to link all your\naccounts under a common manager account, and make API calls to all the accounts\nusing the top-most manager account's credentials. In this configuration:\n\n- The developer issues a refresh token using the credentials of a user who has access to the Google Ads manager account.\n- The developer sets the [`login_customer_id`](/google-ads/api/docs/get-started/select-account#user_access_login_customer_id_and_customer_id) header as the customer ID of the Google Ads manager account, and the `customer_id` header as the customer ID of the account to which API calls are made.\n\nOne potential risk of this setup is that if the authorized user loses access to\nthe Google Ads manager account, the refresh token is no longer valid and all API\ncalls fail. To avoid this scenario, you can invite a shared email alias to\nmanage this Google Ads manager account with the [appropriate access levels](//support.google.com/google-ads/answer/9978556).\nUse this shared email alias to issue the refresh token for making API calls."]]
