Le richieste a ReachPlanService devono fornire 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 riportate in Inizia, tieni presente i seguenti punti:
- 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 API Google Ads. Per maggiori 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 di destinazione sia credenziali OAuth autorizzate ad accedere a quell'ID cliente.
Tuttavia, ReachPlanService è destinato alle attività di pianificazione dei video che potrebbero verificarsi prima di creare un account cliente specifico per l'esecuzione di una campagna.
Strumenti interni
Se crei strumenti per uso interno all'interno della tua organizzazione, valuta le seguenti opzioni:
- Planner senza accesso diretto all'account cliente:se i tuoi planner 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 utilizzando il tuo strumento e collegali al tuo account
amministratore. Quando effettui richieste a
ReachPlanService, fornisci l'ID cliente corrispondente al team dell'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 applicazione di utilizzare le credenziali OAuth dei tuoi planner. Puoi quindi trasmettere 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 client: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 collegali 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:consente agli utenti di concedere al tuo strumento l'accesso ai propri account utilizzando il flusso di autenticazione multiutente. Una volta che un utente concede 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 gli account collegati.
Passaggi successivi
Scopri come specificare un piano media.