Autenticazione

Importante: questa funzionalità è disponibile solo per gli account nella lista consentita. Contatta il tuo rappresentante di Google se hai bisogno di accedere alla funzionalità.

Le richieste inviate a ReachPlanService devono fornire un token sviluppatore approvato, credenziali OAuth e un ID cliente a cui possono accedere le tue credenziali OAuth.

Questa guida illustra i dettagli di autenticazione specifici per ReachPlanService. Se non l'hai già fatto, completa prima i passaggi descritti in Iniziare, quindi torna a questo punto.

Token sviluppatore e credenziali OAuth

Oltre alle indicazioni presentate dalla sezione Inizia, tieni presente quanto segue:

1. Il tuo token sviluppatore deve essere inserito nella lista consentita per potersi connettere alla ReachPlanService, anche se è già approvato per l'utilizzo con altri servizi API Google Ads. Per ulteriori informazioni, consulta i requisiti di idoneità.
2. Per connetterti all'API Google Ads, devi accettare i Termini di servizio dell'API Google Ads.
3. L'utente proprietario del token di aggiornamento OAuth determina su quali ID cliente puoi eseguire query in ReachPlanService. Questi dati forniscono informazioni sull'integrazione. Troverai la spiegazione di seguito.

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 che stai eseguendo, nonché credenziali OAuth autorizzate ad accedere a quell'ID cliente. Tuttavia, ReachPlanService è destinato alle attività di pianificazione video che potrebbero verificarsi prima che tu conosca l'ID cliente specifico in cui eseguiresti una campagna.

Ai partner che creano strumenti per uso interno nella propria organizzazione consigliamo una delle seguenti scelte:

1. Se i tuoi pianificatori non hanno accesso agli account Google Ads dei tuoi clienti: genera le credenziali OAuth utilizzando il flusso delle applicazioni installate 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 collegalo al tuo account amministratore. Quando effettui richieste a ReachPlanService, fornisci l'ID cliente corrispondente al team di un utente.

2. Se i tuoi pianificatori hanno accesso a un account amministratore Google Ads che gestisce gli account dei tuoi clienti: implementa il flusso di applicazioni web per consentire all'app di utilizzare le credenziali OAuth dei pianificatori. Poi puoi inserire l'ID cliente corrispondente al cliente del piano.

Ai partner che creano uno strumento per utenti esterni consigliamo approcci simili:

1. Genera le credenziali OAuth utilizzando il flusso delle applicazioni installate per un utente con accesso all'account amministratore del tuo token sviluppatore. Crea un account Google Ads per un cliente esterno e collegalo al tuo account amministratore. Poi configura lo strumento in modo da fornire l'ID cliente corrispondente di un cliente quando genera i piani.

2. Offri agli utenti la possibilità di concedere al tuo strumento l'accesso ai loro account utilizzando il flusso dell'applicazione web. Quando un utente concede l'autorizzazione, utilizza CustomerService per fornirgli un elenco di account Google Ads a cui può accedere.

L'obiettivo è garantire che i planner abbiano il minore attrito possibile 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, usa il primo approccio consigliato per il tuo tipo di strumento.