Autenticazione

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

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

Questa guida tratta i dettagli di autenticazione specifici di ReachPlanService. Se non l'hai già fatto, completa prima i passaggi descritti in Inizia, poi torna a questo punto.

Token sviluppatore e credenziali OAuth

Oltre alle indicazioni presentate in Inizia, tieni presente quanto segue:

1. Il token sviluppatore deve essere inserito nella lista consentita per connettersi a ReachPlanService, anche se è già approvato per l'utilizzo con altri servizi dell'API Google Ads. Per maggiori 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 nel ReachPlanService. Queste informazioni sono le informazioni necessarie per l'integrazione e sono illustrate più dettagliatamente di seguito.

ID cliente

La maggior parte dei servizi dell'API Google Ads opera su campagne e account Google Ads specifici. Di conseguenza, la maggior parte delle richieste richiede sia un ID cliente, per identificare l'account che gestisci o esegui query, sia credenziali OAuth che dispongono dell'autorizzazione per accedere a quell'ID cliente. Tuttavia, ReachPlanService è destinato alle attività di pianificazione video che possono avvenire prima di conoscere l'ID cliente specifico su cui pubblicheresti una campagna.

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

1. Se i pianificatori non hanno accesso agli account Google Ads dei tuoi clienti: genera le credenziali OAuth utilizzando il flusso dell'applicazione installato 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 invii 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 piani di pianificazione. Dopodiché puoi trasmettere l'ID cliente corrispondente al cliente del tuo piano.

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

1. Genera le credenziali OAuth utilizzando il flusso delle applicazioni installato per un utente con accesso all'account amministratore del tuo token sviluppatore. Crea un account Google Ads per ogni cliente esterno e collegalo al tuo account amministratore. Configura quindi lo strumento in modo da fornire l'ID cliente corrispondente di un cliente durante la generazione dei piani.

2. Offri agli utenti la possibilità di concedere al tuo strumento l'accesso ai propri account utilizzando il flusso delle applicazioni web. Una volta che un utente concede l'autorizzazione, utilizza la CustomerService per fornirgli un elenco di account Google Ads a cui può accedere.

L'obiettivo è garantire che i planner abbiano il minimo 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. Se hai dei dubbi, usa il primo approccio suggerito per il tuo tipo di strumento.