Les requêtes adressées à ReachPlanService doivent
fournir un jeton de développeur approuvé, des identifiants OAuth et un ID client auquel
vos identifiants OAuth peuvent accéder.
Ce guide couvre les détails d'authentification spécifiques à
ReachPlanService. Si ce n'est pas déjà 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 fournis 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 conditions 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 ID client que vous
pouvez interroger dans le
ReachPlanService. Cela informe votre intégration et est 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 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 l'
ID client spécifique sur lequel 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'authentification à utilisateur unique 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 et associez-les à
votre compte administrateur. Lorsque vous envoyez des requêtes à
ReachPlanService fournissez 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'authentification multi-utilisateur pour permettre à votre application d'utiliser les identifiants OAuth de vos planificateurs. Vous pouvez ensuite transmettre l'ID client correspondant au client de votre plan.
Outils externes
Si vous créez un outil pour des utilisateurs externes, nous vous recommandons des approches similaires :
Comptes par client
Générez des identifiants OAuth à l'aide du flux d'authentification à utilisateur unique 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 qu'il fournisse l'ID client correspondant à un client lorsqu'il génère 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 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 le
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.