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.
Dans cette étape, vous identifiez un compte Google Ads pour effectuer des appels d'API. Il peut s'agir d'un compte de production (actif) ou d'un compte de test. Chacune présente des avantages et des inconvénients.
Comptes de production
Comptes de test
Avantages
Il est plus facile d'écrire et de tester du code qui fonctionne avec des contenus de compte spécifiques.
Il est plus facile d'écrire et de tester le code qui traite les données des rapports en temps réel.
Les comptes de test ne diffusent pas d'annonces. Par conséquent, les bugs de programmation n'auront aucune incidence sur vos campagnes actives.
Fonctionne avec les jetons de développeur de niveau d'accès "Test".
Inconvénients
Un bug de programmation lors de la phase de développement peut affecter la diffusion des campagnes en cours, entraînant des problèmes tels que de mauvaises performances, une diffusion incorrecte ou des pertes financières.
Le jeton de développeur doit au moins disposer du niveau d'accès de base pour pouvoir effectuer des appels d'API.
Vous devez reconstruire les campagnes dans les comptes de test pour tester le code qui fonctionne avec des contenus de compte spécifiques.
Étant donné que les comptes de test ne diffusent pas d'annonces, les fonctionnalités liées à la diffusion en direct (comme les statistiques des rapports, les erreurs de non-respect des règles ou le traitement des importations de conversions hors connexion) ne sont pas prises en charge, ce qui rend difficile le test de ces fonctionnalités.
Nous vous recommandons d'utiliser un compte de test lorsque vous développez votre application, dans la mesure du possible. Pour obtenir des instructions, consultez Créer des comptes et des campagnes de test.
Vous pouvez également configurer un compte de production avec un budget de compte faible (par exemple, 1 $/jour) spécifiquement pour tester les fonctionnalités qui ne sont pas compatibles avec un compte de test.
Choix de l'ensemble de caractéristiques
Lorsque vous choisissez un compte pour effectuer un appel d'API, vous devez également tenir compte de la liste des fonctionnalités que vous souhaitez utiliser avec l'API. Même si vous choisissez d'utiliser un compte de production, certaines fonctionnalités sont spécifiques à un compte. Par exemple :
Pour les fonctionnalités de facturation, vous avez besoin d'un compte utilisant la facturation mensuelle.
Il est possible que certaines nouvelles fonctionnalités du compte soient limitées par des listes d'autorisation.
Avant de finaliser le compte pour effectuer des appels d'API, consultez la documentation de la fonctionnalité spécifique pour vous assurer qu'elle ne comporte pas de restrictions supplémentaires.
Identifier le numéro client utilisé pour la connexion et le numéro client
Pour appeler l'API d'un client Google Ads, vous devez accorder l'accès et les autorisations appropriées à votre compte de service pour le compte client, directement ou via un compte administrateur associé. Pour ce faire, vous devez disposer d'un accès administrateur au compte client.
Commencez par vous connecter à votre compte Google Ads en tant qu'administrateur. Dans certains cas, vous pouvez choisir parmi plusieurs comptes client. Le compte que vous sélectionnez établit l'ID client de connexion, qui est un en-tête requis pour certains appels d'API.
Une fois que vous avez identifié le client Google Ads auprès duquel effectuer des appels d'API, notez les informations suivantes :
Numéro client à 10 chiffres du compte client pour lequel vous prévoyez d'effectuer des appels d'API. On parle parfois de client opérateur.
Numéro client à 10 chiffres du compte client auquel vous êtes connecté.
Si vous êtes connecté au client opérationnel, l'ID client de connexion est identique à l'ID client. Si vous vous êtes connecté à un compte administrateur du client opérationnel, le numéro client de connexion est celui du compte administrateur.
Accorder l'accès au compte de service
Connectez-vous à votre compte Google Ads en tant qu'administrateur, puis accédez à Admin > Accès et sécurité.
Cliquez sur le bouton + dans l'onglet Utilisateurs.
Saisissez l'adresse e-mail du compte de service dans la zone de saisie Adresse e-mail. Sélectionnez le niveau d'accès au compte approprié, puis cliquez sur le bouton Ajouter un compte. Notez que le niveau d'accès "E-mail" n'est pas compatible avec les comptes de service.
L'accès est accordé au compte de service.
Par défaut, vous ne pouvez pas accorder l'accès administrateur à un compte de service. Si vos appels d'API nécessitent un accès administrateur, vous pouvez l'obtenir comme suit.
Cliquez sur la flèche du menu déroulant à côté du niveau d'accès du compte de service dans la colonne Niveau d'accès.
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\u003eChoose a Google Ads account (production or test) to make API calls, noting its email address for generating OAuth 2.0 refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eTest accounts are recommended for development to prevent affecting live campaigns; however, they don't support features related to live serving.\u003c/p\u003e\n"],["\u003cp\u003eProduction accounts, with a low budget, can be used to test features unsupported by test accounts, but a programming bug can affect live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eEnsure the selected account supports the desired features as some features have account-specific restrictions.\u003c/p\u003e\n"],["\u003cp\u003eTo make API calls, you need access to the customer account, the 10-digit customer ID, email address for OAuth 2.0 token generation, and the 10-digit login customer ID.\u003c/p\u003e\n"]]],[],null,["# Prepare the customer account\n\n**Note:** The current step of this tutorial depends on the [type of application](/google-ads/api/docs/get-started/choose-application-type) you are building. We strongly recommend using service account to make API calls. However, the user authentication option is also provided as an alternative. The rest of this tutorial will be customized based on your choice. \nService accounts User authentication\n\nIn this step, you identify a Google Ads account to make API calls to. The account\ncan either be a production (live) account or a test account. Each approach has\nits advantages and disadvantages.\n\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | ##### Production accounts | ##### Test accounts |\n| ##### Advantages | - Easier to write and test code that works against specific account contents. - Easier to write and test code that processes live reporting data. | - Test accounts *don't* serve ads, hence programming bugs won't affect your live campaigns. - Works with developer tokens that have Test Access level. |\n| ##### Disadvantages | - A programming bug in the development phase could affect live campaign serving, leading to issues such as poor campaign performance, incorrect serving, or financial losses. - The developer token should have at least the Basic Access level to in order to make API calls. | - You must reconstruct campaigns within test accounts to test code that works against specific account contents. - Since test accounts don't serve ads, features related to live serving such as reporting stats, policy violation errors, or processing offline conversion imports are not supported, making it difficult to test those features. |\n\nWe recommend using a test account while developing your application when\npossible. For instructions, see [Create test accounts and\ncampaigns](/google-ads/api/docs/best-practices/test-accounts#create).\n\nAn alternative is to set up a production account with a low account budget,\nsuch as $1/day, explicitly for testing features that are not supported by a\ntest account.\n\nChoice of feature set\n---------------------\n\nWhen choosing an account for making API call, an additional consideration is\nthe list of features you'd want to use with the API. Even if you choose to use\na production account, there are some features that are account-specific, for\nexample:\n\n- For billing features, you need an account that is on monthly invoicing.\n- Some new features in the account might be restricted by allowlists.\n\nBefore finalizing the account to make API calls against, check the\ndocumentation of the specific feature to make sure that the feature doesn't\nhave additional restrictions.\n\nIdentify the login customer ID and customer ID\n----------------------------------------------\n\nTo make an API call to a Google Ads customer, you must grant access and\nappropriate permissions to your service account to the customer account\neither directly or through a linked manager account. To do this, you need\nadministrator access to the customer account.\n\nStart by signing in to your Google Ads account as an administrator. In some cases,\nyou might have more than one customer account to choose from. The account you\nselect establishes the login customer ID, which is a required header for some\nAPI calls.\n\nAfter you've identified the Google Ads customer to make API calls to, note the\nfollowing details:\n\n- The 10-digit customer ID of the customer account to which you plan to make\n API calls against. This is sometimes referred to as the operating customer.\n\n- The 10-digit login customer ID of the customer account you're signed in to.\n If you're signed in to the operating customer, the login customer ID is the\n same as the customer ID. If you signed into a manager account of the\n operating customer, the login customer ID is the customer ID of the manager\n account.\n\nGrant access to the service account\n-----------------------------------\n\n1. While signed in to your Google Ads account as an administrator, navigate to\n **Admin \\\u003e Access and security**.\n\n2. Click the **+** button under the **Users** tab.\n\n3. Type the service account email address into the **Email** input box. Select\n the appropriate level of account access level and click the **Add account**\n button. Note that Email access level is not supported for service accounts.\n\n4. The service account is granted access.\n\nBy default, you cannot grant administrator access to a service account. If your\nAPI calls require administrator access, you can upgrade the access as follows.\n\n1. Click the drop-down arrow next to the access level of the service account\n in the **Access level** column.\n\n2. Select **Admin** from the drop-down list."]]
