Les requêtes adressées à ReachPlanService doivent
fournir les identifiants OAuth et un numéro client auquel vos identifiants OAuth peuvent
accéder. De plus, le projet Google Cloud auquel appartiennent les identifiants OAuth doit être approuvé pour l'utilisation de ce service.
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.
Identifiants OAuth
En plus des conseils présentés dans Premiers pas, voici quelques points à retenir :
- Le numéro de votre 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 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 numéros client que vous
pouvez interroger dans le
ReachPlanService. Cela a une incidence sur votre intégration et est expliqué plus en détail dans les sections suivantes.
Numéros 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 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 le
numéro 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 à
votre compte administrateur. Créez ensuite un compte Google Ads pour chaque équipe
qui utilise votre outil et associez-les à votre compte administrateur.
Lorsque vous effectuez des requêtes auprès de ReachPlanService
fournissez le numéro 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 le numéro 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 à votre compte administrateur. Créez un compte Google Ads par client externe et associez-les à votre compte administrateur. Configurez ensuite votre outil pour qu'il fournisse le numéro 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 réduire au maximum les frictions pour les planificateurs 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 numéros 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.