Les requêtes adressées à ReachPlanService doivent fournir des identifiants OAuth et un numéro client auquel vos identifiants OAuth peuvent accéder. De plus, le projet Google Cloud associé à vos identifiants OAuth doit être approuvé pour utiliser ce service.
Ce guide traite des détails d'authentification spécifiques à ReachPlanService. Si vous ne l'avez pas déjà fait, suivez d'abord les étapes décrites dans Premiers pas, puis revenez à ce guide.
Identifiants OAuth
En plus des conseils présentés dans Premiers pas, tenez compte des points suivants :
- Votre numéro de projet Google Cloud doit être ajouté à la liste d'autorisation appropriée pour vous 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 vous permet d'orienter votre intégration, comme expliqué plus en détail dans les sections suivantes.
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 cible 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 créiez un compte client spécifique pour diffuser une campagne.
Outils internes
Si vous créez des outils destinés à un usage interne au sein de votre organisation, tenez compte des options suivantes :
- Planificateurs sans accès direct au compte client : 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'authentification mono-utilisateur pour un utilisateur ayant accès à votre compte administrateur. Ensuite, créez ou obtenez un compte Google Ads pour chaque équipe qui utilise votre outil, puis associez-les à votre compte administrateur. Lorsque vous envoyez des requêtes à
ReachPlanService, indiquez le numéro client correspondant à l'équipe de l'utilisateur. - Planificateurs ayant accès au compte client : si vos planificateurs ont accès à un compte administrateur Google Ads qui gère les comptes de vos clients, implémentez le flux d'authentification multi-utilisateur pour permettre à votre application d'utiliser les identifiants OAuth de vos planificateurs. Vous pouvez ensuite transmettre le numéro client correspondant au forfait client.
Outils externes
Si vous créez des outils pour des utilisateurs tiers ou externes, nous vous recommandons les options suivantes :
- Comptes clients : générez des identifiants OAuth à l'aide du flux d'authentification pour un seul utilisateur pour un utilisateur ayant accès à votre compte administrateur. Créez un compte Google Ads par client externe et associez-les à votre compte administrateur. Configurez votre outil pour qu'il fournisse le numéro client correspondant lors de la génération des plans.
- Accès accordé par l'utilisateur : permettez à vos utilisateurs d'accorder à votre outil l'accès à leurs comptes à l'aide du flux d'authentification multi-utilisateur. Une fois que l'utilisateur a accordé l'autorisation, utilisez
CustomerServicepour récupérer la liste des comptes Google Ads auxquels il peut accéder.
Avant d'intégrer l'API, sélectionnez l'une des approches précédentes en fonction de la configuration système requise et identifiez quelques numéros client de test. En cas de doute, commencez par le parcours d'authentification mono-utilisateur avec des comptes associés.
Étape suivante
Découvrez comment spécifier un plan média.