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 di
ReachPlanService. Se non l'hai ancora fatto, completa prima
i passaggi descritti in Inizia, poi torna a questa guida.
Credenziali OAuth
Oltre alle indicazioni fornite in Inizia, tieni presente i seguenti punti:
- 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 dell'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 che puoi interrogare in
ReachPlanService. Queste informazioni sono utili per l'integrazione e sono spiegate 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 di destinazione sia le credenziali OAuth autorizzate ad accedere a quell'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 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 a utente singolo
per un utente con accesso al tuo account amministratore. 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 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. Poi, puoi passare l'ID cliente corrispondente al piano cliente.
Strumenti esterni
Se crei strumenti per utenti di terze parti o esterni, ti consigliamo le seguenti opzioni:
- Account cliente: genera le credenziali OAuth utilizzando il flusso di autenticazione a utente singolo 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 quando generi i piani.
- Accesso concesso dall'utente: consenti 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
il
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 a utente singolo con gli account collegati.
Passaggi successivi
Scopri come specificare un piano media.