Les requêtes adressé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 couvre les 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 stade.
Jeton de développeur et identifiants OAuth
En plus des conseils présentés dans la section Premiers pas, gardez à l'esprit les points suivants:
- Votre jeton de développeur doit être ajouté à la liste d'autorisation pour pouvoir se connecter à
ReachPlanService, même s'il a déjà été approuvé pour être utilisé avec d'autres services de l'API Google Ads. Pour en savoir plus, consultez les critères d'éligibilité. - Pour vous connecter à cette API, vous devez accepter les conditions d'utilisation de l'API Google Ads.
- L'utilisateur propriétaire de votre jeton d'actualisation OAuth détermine les ID client que vous pouvez interroger dans
ReachPlanService. Cela permet de définir votre intégration. Vous trouverez plus de détails 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 ID client pour identifier le compte que vous gérez ou interrogez, et des identifiants OAuth autorisés à accéder à cet ID client. Toutefois, ReachPlanService est destiné aux activités de planification vidéo qui peuvent avoir lieu avant que vous ne connaissiez le numéro client spécifique dans lequel vous diffuseriez une campagne.
Pour les partenaires qui créent des outils pour une utilisation 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 ou obtenez ensuite un compte Google Ads pour chaque équipe utilisant votre outil, puis associez-les à votre compte administrateur. Lorsque vous envoyez des requêtes à
ReachPlanService, fournissez le numéro 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: mettez en œuvre le flux d'application Web pour permettre à votre application d'utiliser les identifiants OAuth de vos planificateurs. Vous pouvez ensuite transmettre le numéro client correspondant au client de votre forfait.
Pour les partenaires qui créent un outil pour les 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 par client externe et associez-les à votre compte administrateur. Configurez ensuite votre outil pour fournir le numéro client correspondant à un client lorsqu'il génère des plans.
Donnez à vos utilisateurs la possibilité d'autoriser votre outil à accéder à leurs comptes à l'aide du parcours d'application Web. Une fois qu'un utilisateur a accordé son autorisation, utilisez
CustomerServicepour lui fournir une liste des comptes Google Ads auxquels il peut accéder.
L'objectif est de s'assurer que les responsables de la planification utilisent le moins de friction 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.