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 couvre les informations d'authentification spécifiques à ReachPlanService. Si vous ne l'avez pas encore fait, suivez d'abord la procédure décrite 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 appropriée 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 vous aidera à intégrer le SDK. Nous y reviendrons plus en détail dans les sections suivantes.
Identifiants client
La plupart des services de l'API Google Ads fonctionnent sur des comptes et 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.
Outils internes
Si vous créez des outils à usage interne dans votre organisation, voici nos recommandations.
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'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.
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'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.
Outils externes
Si vous créez un outil pour des utilisateurs externes, nous vous recommandons d'adopter des approches similaires :
Comptes par client
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.
Accès accordé par l'utilisateur
Donnez à vos utilisateurs la possibilité 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 réduire au maximum les frictions pour les planificateurs 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.
Étape suivante
Découvrez comment spécifier un plan média.