Le richieste a ReachPlanService devono
fornire le credenziali OAuth e un ID cliente a cui le credenziali OAuth possono
accedere. Inoltre, il progetto Google Cloud a cui appartengono le credenziali OAuth deve essere approvato per l'utilizzo di questo servizio.
Questa guida illustra i dettagli di autenticazione specifici di
ReachPlanService. Se non l'hai ancora fatto,
completa prima i passaggi descritti in
Guida introduttiva, quindi torna a questo punto.
Credenziali OAuth
Oltre alle indicazioni fornite in Get started, tieni presente quanto segue:
- Il numero del tuo progetto Google Cloud 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 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 eseguire 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 di autenticazione a utente singolo per un utente con accesso al
tuo account amministratore. 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.
Pianificatori 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 di autenticazione multiutente 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 di autenticazione a utente singolo per un utente con accesso al tuo account amministratore. 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 pianificatori abbiano il minor attrito possibile quando utilizzano il
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.