Le richieste all'ReachPlanService devono fornire le credenziali OAuth e un ID cliente a cui le credenziali OAuth possono accedere. Inoltre, il progetto Google Cloud associato alle tue credenziali OAuth deve essere approvato per l'utilizzo di questo servizio.
Questa guida illustra i dettagli di autenticazione specifici per ReachPlanService. Se non l'hai ancora fatto, completa prima i passaggi descritti in Inizia, poi torna a questa guida.
Credenziali OAuth
Oltre alle indicazioni presentate in Inizia, tieni presente quanto segue:
- Il numero del tuo progetto Google Cloud deve essere aggiunto alla lista consentita appropriata per connetterti a
ReachPlanService, anche se è già approvato per l'utilizzo con altri servizi API Google Ads. Per saperne di più, 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 su cui puoi eseguire query in
ReachPlanService. Questo aspetto influisce sulla tua integrazione ed è spiegato 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 target sia credenziali OAuth autorizzate ad accedere a questo ID cliente.
Tuttavia, ReachPlanService è destinato alle attività di pianificazione video che potrebbero verificarsi prima di creare un account cliente specifico per la pubblicazione di una campagna.
Strumenti interni
Se crei strumenti per uso interno alla tua organizzazione, prendi in considerazione le seguenti opzioni:
- 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 per un singolo utente 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 collegalo al tuo account amministratore. Quando effettui richieste a
ReachPlanService, fornisci l'ID cliente corrispondente al team dell'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 applicazione di utilizzare le credenziali OAuth dei tuoi pianificatori. Puoi quindi passare l'ID cliente corrispondente al piano del cliente.
Strumenti esterni
Se crei strumenti per utenti esterni o di terze parti, ti consigliamo le seguenti opzioni:
- Account per cliente: genera le credenziali OAuth utilizzando il flusso di autenticazione per un singolo utente per un utente con accesso al tuo account amministratore. Crea un account Google Ads per ogni cliente esterno e collegalo al tuo account amministratore. Configura lo strumento in modo che fornisca l'ID cliente corrispondente del cliente durante la generazione dei 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 ha concesso l'autorizzazione, utilizza
CustomerServiceper recuperare l'elenco degli account Google Ads a cui può accedere.
Prima di integrare l'API, seleziona uno degli approcci precedenti in base ai requisiti di sistema e identifica alcuni ID cliente di test. In caso di dubbi, inizia con il flusso di autenticazione per un singolo utente con account collegati.
Passaggi successivi
Scopri come specificare un piano media.