Les requêtes adressées à ReachPlanService doivent fournir des identifiants OAuth
et un numéro client auquel vos identifiants OAuth peuvent accéder. De plus, le projet Google Cloud associé à vos identifiants OAuth doit être approuvé pour utiliser 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 guide.
Identifiants OAuth
En plus des conseils présentés dans Premiers pas, gardez les points suivants à l'esprit :
- Vous devez ajouter le numéro de votre projet Google Cloud à 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 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 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 numéro client pour identifier le compte cible 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 n'établissiez un compte client spécifique pour
diffuser une campagne.
Outils internes
Si vous créez des outils à usage interne dans votre organisation, tenez compte des options suivantes :
- 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. Ensuite, créez ou obtenez un
compte Google Ads pour chaque équipe à l'aide de votre outil et associez-les à votre compte administrateur
account. Lorsque vous effectuez des requêtes auprès de
ReachPlanService, fournissez le numéro client correspondant à l'équipe de l'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 plan client.
Outils externes
Si vous créez des outils pour des tiers ou des utilisateurs externes, nous vous recommandons les options suivantes :
- Comptes 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 un compte Google Ads par client externe et associez-les à votre compte administrateur. Configurez votre outil pour qu'il fournisse le numéro client correspondant du client lors de la génération de plans.
- Accès accordé par l'utilisateur : autorisez vos utilisateurs à 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
CustomerServicepour récupérer la liste des comptes Google Ads auxquels il peut accéder.
Avant d'intégrer l'API, sélectionnez l'une des approches précédentes en fonction de la configuration système requise et identifiez quelques numéros client de test. En cas de doute, commencez par le flux d'authentification à utilisateur unique avec des comptes associés.
Étape suivante
Découvrez comment spécifier un plan média.