Authentication

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

Questa guida illustra i dettagli di autenticazione specifici per ReachPlanService. Se non l'hai ancora fatto, completa prima i passaggi descritti in Guida introduttiva, poi torna a questo punto.

Token sviluppatore e credenziali OAuth

Oltre alle indicazioni riportate in Inizia qui, 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 relativi Termini di servizio.
3. 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 di seguito.

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 che stai gestendo o interrogando, sia credenziali OAuth che dispongono dell'autorizzazione per accedere a quell'ID cliente. Tuttavia, ReachPlanService è destinato alle attività di pianificazione dei video che potrebbero verificarsi prima di conoscere l'ID cliente specifico in cui verrà pubblicata una campagna.

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

1. Se i tuoi pianificatori non hanno accesso agli account Google Ads dei tuoi clienti: genera le credenziali OAuth utilizzando il flusso dell'applicazione installata 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 collegali 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 dell'applicazione web per consentire alla tua app di utilizzare le credenziali OAuth dei tuoi pianificatori. A questo punto, puoi inserire l'ID cliente corrispondente al cliente del tuo piano.

Per i partner che creano uno strumento per utenti esterni, consigliamo approcci simili:

1. Genera le credenziali OAuth utilizzando il flusso dell'applicazione installata per un utente con accesso all'account amministratore del token sviluppatore. Crea un account Google Ads per ogni cliente esterno e collegalo al tuo account amministratore. Quindi, configura lo strumento in modo che fornisca l'ID cliente corrispondente di un cliente quando genera i piani.

2. Consenti agli utenti di concedere al tuo strumento l'accesso ai propri account utilizzando il flusso dell'applicazione web. Una volta che un utente concede l'autorizzazione, utilizza CustomerService per fornirgli un elenco degli account Google Ads a cui può accedere.

L'obiettivo è garantire che i pianificatori incontrino il minor numero possibile di difficoltà 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, utilizza il primo approccio suggerito per il tuo tipo di strumento.