Le richieste a ReachPlanService devono
fornire un token sviluppatore approvato, credenziali OAuth e un ID cliente a cui
le credenziali OAuth possono accedere.
Questa guida illustra i dettagli di autenticazione specifici di
ReachPlanService. Se non l'hai ancora fatto,
completa prima i passaggi descritti in Inizia, quindi torna a questo punto.
Token sviluppatore e credenziali OAuth
Oltre alle indicazioni fornite in Inizia, tieni presente quanto segue:
- Il token sviluppatore deve essere aggiunto alla lista consentita appropriata per connettersi
a
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 Termini di servizio dell'API Google Ads.
- L'utente proprietario del token di aggiornamento OAuth determina gli ID cliente che puoi interrogare in
ReachPlanService. Queste informazioni sono utili per l'integrazione e sono spiegate in modo più dettagliato nelle sezioni seguenti.
ID cliente
La maggior parte dei servizi 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 le credenziali
OAuth che hanno l'autorizzazione ad 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 eseguire una campagna.
Strumenti interni
Se crei strumenti per uso interno nella tua organizzazione, ecco i nostri consigli.
Planner senza accesso diretto all'account cliente
Se i tuoi planner non hanno accesso agli account Google Ads dei clienti,
genera le credenziali OAuth utilizzando il flusso di autenticazione a utente singolo
per un utente con accesso all'account amministratore
del token sviluppatore. Poi crea o ottieni
un account Google Ads per ogni team che utilizza lo 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 planner hanno accesso a un account amministratore Google Ads che gestisce gli account dei tuoi clienti, implementa il flusso di autenticazione multiutente per consentire alla tua app di utilizzare le credenziali OAuth dei tuoi planner. 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 di autenticazione a utente singolo per un utente con accesso all' account amministratore del token sviluppatore. Crea un account Google Ads per ogni cliente esterno e collegali al tuo account amministratore. Poi 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 loro account
utilizzando il flusso di autenticazione multiutente. Una volta che un utente concede
l'autorizzazione, utilizza
CustomerService per fornire
loro un elenco di account Google Ads a cui possono accedere.
L'obiettivo è garantire che i planner abbiano il minor attrito possibile quando utilizzano the
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 tipo di strumento.
Passaggi successivi
Scopri come specificare un piano media.