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.
Les requêtes envoyées à ReachPlanService doivent fournir un jeton de développeur approuvé, des identifiants OAuth et un numéro client auquel vos identifiants OAuth peuvent accéder.
Ce guide fournit des informations sur l'authentification spécifiques à ReachPlanService. Si vous ne l'avez pas encore fait, suivez d'abord les étapes décrites dans Premiers pas, puis revenez à ce point.
Jeton de développeur et identifiants OAuth
En plus des conseils présentés dans Premiers pas, gardez à l'esprit les points suivants :
Votre jeton de développeur doit être ajouté à la liste d'autorisation pour se connecter à ReachPlanService, même s'il est déjà approuvé pour une utilisation avec d'autres services de l'API Google Ads. Pour en savoir plus, consultez les critères d'éligibilité.
Vous devez accepter les conditions d'utilisation de l'API Google Ads pour vous y connecter.
L'utilisateur qui possède votre jeton d'actualisation OAuth détermine les numéros client que vous pouvez interroger dans ReachPlanService.
Cela a une incidence sur votre intégration. Pour en savoir plus, consultez les informations ci-dessous.
Identifiants client
La plupart des services de l'API Google Ads fonctionnent sur des comptes et des campagnes Google Ads spécifiques. Par conséquent, la plupart des requêtes nécessitent à la fois un numéro client pour identifier le compte que vous gérez ou interrogez, et des identifiants OAuth autorisés à accéder à ce numéro client. Toutefois, ReachPlanService est destiné aux activités de planification vidéo qui peuvent avoir lieu avant que vous ne connaissiez l'ID client spécifique où vous diffuserez une campagne.
Pour les partenaires qui créent des outils à usage interne dans leur organisation, nous recommandons l'une des options suivantes :
Si vos planificateurs n'ont pas accès aux comptes Google Ads de vos clients :
Générez des identifiants OAuth à l'aide du flux d'application installée pour un utilisateur ayant accès au compte administrateur de votre jeton de développeur. Créez ensuite un compte Google Ads pour chaque équipe qui utilise votre outil ou obtenez-en un, puis associez-les à votre compte administrateur. Lorsque vous envoyez des requêtes à ReachPlanService, indiquez l'ID client correspondant à l'équipe d'un utilisateur.
Si vos planificateurs ont accès à un compte administrateur Google Ads qui gère les comptes de vos clients : implémentez le flux d'application Web pour permettre à votre application d'utiliser les identifiants OAuth de vos planificateurs. Vous pouvez ensuite transmettre l'ID client correspondant au client de votre forfait.
Pour les partenaires qui créent un outil destiné à des utilisateurs externes, nous recommandons des approches similaires :
Générez des identifiants OAuth à l'aide du flux d'application installée pour un utilisateur ayant accès au compte administrateur de votre jeton de développeur. Créez un compte Google Ads pour chaque client externe et associez-le à votre compte administrateur. Configurez ensuite votre outil pour qu'il fournisse l'ID client correspondant d'un client lorsqu'il génère des plans.
Permettez à vos utilisateurs d'accorder à votre outil l'accès à leurs comptes en utilisant le flux d'application Web. Une fois qu'un utilisateur a accordé l'autorisation, utilisez CustomerService pour lui fournir une liste des comptes Google Ads auxquels il peut accéder.
L'objectif est de s'assurer que les planificateurs rencontrent le moins de difficultés possible lorsqu'ils utilisent ReachPlanService. Avant d'intégrer l'API, sélectionnez l'une des deux approches en fonction de votre situation et identifiez quelques ID client à tester. En cas de doute, utilisez la première approche suggérée pour votre type d'outil.
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/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eThe ReachPlanService API requires allowlisted access, an approved developer token, OAuth credentials, and a valid customer ID.\u003c/p\u003e\n"],["\u003cp\u003eYour developer token needs to be specifically allowlisted for ReachPlanService, and you must accept the Google Ads API Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eCustomer ID selection depends on whether planners have access to client accounts or use a manager account, impacting OAuth credential flow.\u003c/p\u003e\n"],["\u003cp\u003ePartners building internal tools can choose between using a manager account with linked team accounts or leveraging planners' existing manager account access.\u003c/p\u003e\n"],["\u003cp\u003ePartners building external tools can use a similar approach, either linking client accounts to a manager account or utilizing the web application flow for direct user account access.\u003c/p\u003e\n"]]],[],null,["# Authentication\n\n| **Important:** This feature is available to allowlisted accounts only. Contact your Google representative if you need access to the feature.\n\n\u003cbr /\u003e\n\nRequests to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) must\nsupply an approved developer token, OAuth credentials, and a customer ID that\nyour OAuth credentials can access.\n\nThis guide covers authentication details specific to\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). If you haven't already,\nfirst complete the steps outlined in [Get\nstarted](/google-ads/api/docs/get-started/introduction), then come back to this point.\n\nDeveloper token and OAuth credentials\n-------------------------------------\n\nIn addition to the guidance presented by [Get\nstarted](/google-ads/api/docs/get-started/introduction), keep the following points in mind:\n\n1. Your developer token must be allowlisted to connect to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService), even if it's already approved for use with other Google Ads API services. For more information, see the [eligibility\n requirements](/google-ads/api/docs/reach-forecasting#eligibility).\n2. You must accept the Google Ads API Terms of Service in order to connect to the Google Ads API.\n3. The user who owns your OAuth refresh token determines which customer IDs you can query in the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). This informs your integration and is explained in more details below.\n\nCustomer IDs\n------------\n\nMost services within the Google Ads API operate on specific Google Ads accounts and\ncampaigns. As a result, most requests require both a customer ID to identify\nthe account you're managing or querying, and [OAuth\ncredentials](/google-ads/api/docs/oauth/overview) that have permission to access that\ncustomer ID. However, [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService)\nis meant for video planning activities that might occur before you know the\nspecific customer ID where you would run a campaign.\n\nFor partners who build tools for internal use in their organization, we\nrecommend one of the following choices:\n\n1. **If your planners don't have access to your clients' Google Ads accounts** :\n Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Then create or obtain\n a Google Ads account for each team that uses your tool, and [link them to\n your manager account](//support.google.com/google-ads/answer/7459601). When making requests to\n [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) provide the customer ID\n corresponding to a user's team.\n\n2. **If your planners have access to a Google Ads manager account that manages\n your clients' accounts** : Implement the *web application flow* to allow your\n app to use your planners' OAuth credentials. Then you can pass in the\n customer ID corresponding to the customer of your plan.\n\nFor partners who build a tool for external users, we recommend similar\napproaches:\n\n1. Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Create a Google Ads\n account per external client and [link them to your manager\n account](//support.google.com/google-ads/answer/7459601). Then configure your tool to provide a client's\n corresponding customer ID when they're generating plans.\n\n2. Give your users the ability to grant your tool access to their accounts\n by using the *web application flow* . Once a user grants permission, use the\n [`CustomerService`](/google-ads/api/docs/account-management/listing-accounts) to provide\n them with a list of Google Ads accounts they can access.\n\nThe goal is to ensure planners have the lowest possible friction when using the\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). Before you integrate the\nAPI, select one of the two approaches according to your situation and identify\na few customer IDs to test. If in doubt, use the first suggested approach for\nyour tool type."]]
