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 décrit les informations d'authentification spécifiques à ReachPlanService. Si vous ne l'avez pas déjà fait, suivez d'abord la procédure décrite dans la section Premiers pas, puis revenez à ce stade.
Jeton de développeur et identifiants OAuth
En plus des conseils fournis dans la section Premiers pas, tenez compte des points suivants:
- Votre jeton de développeur doit être ajouté à la liste d'autorisation pour 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é. - Vous devez accepter les conditions d'utilisation de l'API Google Ads pour vous connecter à l'API Google Ads.
- L'utilisateur propriétaire de votre jeton d'actualisation OAuth détermine les numéros client que vous pouvez interroger dans
ReachPlanService. Ces informations servent de base à votre intégration et sont expliquées plus en détail ci-dessous.
Identifiants client
La plupart des services de l'API Google Ads fonctionnent pour 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. Cependant, 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 pour lequel vous allez diffuser une campagne.
Nous recommandons l'une des options suivantes aux partenaires qui créent des outils pour une utilisation interne dans leur organisation:
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'applications installées pour un utilisateur ayant accès au compte administrateur de votre jeton de développeur. 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 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 parcours 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.
Nous recommandons des approches similaires aux partenaires qui créent un outil pour les utilisateurs externes:
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-le à votre compte administrateur. Configurez ensuite votre outil pour fournir le numéro client correspondant à un client lorsqu'il génère des plans.
Permettez à vos utilisateurs d'autoriser votre outil à accéder à leur compte à l'aide du flux d'application Web. Une fois qu'un utilisateur donne son autorisation, utilisez
CustomerServicepour lui fournir la liste des comptes Google Ads auxquels il peut accéder.
L'objectif est de s'assurer que les planificateurs présentent le moins de friction possible lors de l'utilisation de ReachPlanService. Avant d'intégrer l'API, sélectionnez l'une des deux approches en fonction de votre situation et identifiez quelques numéros client à tester. En cas de doute, utilisez la première approche suggérée pour votre type d'outil.