Le richieste all'ReachPlanService devono
fornire un token sviluppatore approvato, credenziali OAuth e un ID cliente a cui
le tue credenziali OAuth possono accedere.
Questa guida illustra i dettagli di autenticazione specifici per
ReachPlanService. Se non l'hai ancora fatto,
completa prima i passaggi descritti in Guida
introduttiva, poi torna a questo punto.
Token sviluppatore e credenziali OAuth
Oltre alle indicazioni riportate in Inizia a utilizzare, tieni presente quanto segue:
- Il token sviluppatore deve essere aggiunto all'allowlist appropriata per connettersi
all'
ReachPlanService, anche se è già approvato per l'utilizzo con altri servizi dell'API Google Ads. Per ulteriori informazioni, consulta i requisiti di idoneità. - Per connetterti all'API Google Ads, devi accettare i relativi Termini di servizio.
- L'utente proprietario del token di aggiornamento OAuth determina gli ID cliente che puoi
interrogare in
ReachPlanService. Queste informazioni vengono utilizzate per l'integrazione e sono spiegate in modo più dettagliato nelle sezioni seguenti.
ID cliente
La maggior parte dei servizi all'interno dell'API Google Ads opera su account e campagne Google Ads specifici. Di conseguenza, la maggior parte delle richieste richiede sia un ID cliente per identificare l'account che stai gestendo o interrogando, sia credenziali OAuth che dispongono dell'autorizzazione per accedere a quell'ID cliente. Tuttavia, ReachPlanService
è destinato alle attività di pianificazione video che potrebbero verificarsi prima di conoscere
l'ID cliente specifico in cui pubblicare una campagna.
Strumenti interni
Se crei strumenti per uso interno nella tua organizzazione, ecco i nostri consigli.
Pianificatori senza accesso diretto all'account cliente
Se i tuoi pianificatori non hanno accesso agli account Google Ads dei tuoi clienti,
genera le credenziali OAuth utilizzando il flusso dell'applicazione installata per un utente
con accesso all'account amministratore del tuo token sviluppatore. Poi crea o ottieni
un account Google Ads per ogni team che utilizza il tuo strumento e collegali al
tuo account amministratore. Quando effettui richieste a
ReachPlanService, fornisci l'ID cliente
corrispondente al team di un utente.
Planner con accesso all'account cliente
Se i tuoi pianificatori hanno accesso a un account amministratore Google Ads che gestisce gli account dei tuoi clienti, implementa il flusso dell'applicazione web per consentire alla tua app di utilizzare le credenziali OAuth dei tuoi pianificatori. Poi puoi inserire l'ID cliente corrispondente al cliente del tuo piano.
Strumenti esterni
Se crei uno strumento per utenti esterni, ti consigliamo approcci simili:
Account per cliente
Genera le credenziali OAuth utilizzando il flusso dell'applicazione installata per un utente con accesso all'account amministratore del token sviluppatore. Crea un account Google Ads per ogni cliente esterno e collegalo al tuo account amministratore. Quindi, configura lo strumento in modo che fornisca l'ID cliente corrispondente di un cliente quando genera i piani.
Accesso concesso dall'utente
Consenti agli utenti di concedere al tuo strumento l'accesso ai propri account
utilizzando il flusso dell'applicazione web. Una volta che un utente concede l'autorizzazione, utilizza
CustomerService per fornirgli
un elenco degli account Google Ads a cui può accedere.
L'obiettivo è garantire che i pianificatori incontrino il minor numero possibile di difficoltà quando utilizzano
ReachPlanService. Prima di integrare l'API, seleziona uno dei due approcci in base alla tua situazione e identifica alcuni ID cliente da testare. In caso di dubbi, utilizza il primo approccio suggerito per
il tuo tipo di strumento.
Passaggi successivi
Scopri come specificare un piano media.