L'API di reporting di DV360 Exchange fornisce ai partner di piattaforme di scambio di terze parti (3PE) l'accesso programmatico ai report sul rendimento di Display &Video 360.
L'API di reporting di DV360 Exchange è esposta come API Google Cloud basata su lista consentita che utilizza OAuth. La procedura di lista consentita viene gestita dal team dell'API di reporting di DV360 Exchange.
Procedura
Ecco i passaggi di onboarding dell'API di reporting di DV360 Exchange:
Registra un Account Google nella console Google Cloud.
Tieni presente che questo account deve essere utilizzato per gestire i token di accesso per il client di produzione, quindi non utilizzare il tuo account Gmail personale.
Contatta Google DV360 con le informazioni dell'account per aggiungerlo alla lista consentita.
Dopo aver ricevuto la notifica che ti è stata aggiunta alla lista consentita, richiedi una revisione di verifica OAuth per consentire alla tua app di accedere all'ambito
doubleclickbidmanager.Accedi alla console Google Cloud.
Vai ad API e servizi > Libreria > Privato. Dovresti vedere l'API di reporting di DV360 Exchange elencata tra le API a tua disposizione. Abilita l'API di reporting di DV360 Exchange.
Vai a Credenziali > Crea una credenziale > Chiave dell'account di servizio. Segui le istruzioni per creare un account di servizio.
Service account
Un account di servizio consente al tuo codice di inviare le credenziali dell'applicazione direttamente all'API. Un service account, come un account utente, è rappresentato da un indirizzo email. A differenza di un account utente, tuttavia, un account di servizio appartiene solo a un'applicazione e può essere utilizzato solo per accedere all'API per cui è stato creato.
Ecco i passaggi per creare le credenziali dell'account di servizio utilizzando la console Google Cloud:
Dalla pagina Gestione API > Credenziali, seleziona Crea credenziali → Chiave dell'account di servizio.
Seleziona Nuovo account di servizio dal menu a discesa Account di servizio.
Inserisci un nome per questo account di servizio. Questo nome viene utilizzato come nome predefinito per il tuo ID account di servizio, a sinistra di
@nell' indirizzo ID account di servizio generato.In Tipo di chiave, ti consigliamo di lasciare questo valore come
JSON. Fai clic su Crea per generare una chiave JSON come file di testo.json. Quando ti viene richiesto, scarica il file sul computer e viene visualizzata la finestra di dialogo Service account creato.
Ecco un esempio di chiave JSON:
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }Archivia il file JSON in modo sicuro, poiché contiene la chiave privata e questo file è l'unica copia della chiave. Le credenziali in questo file sono necessarie quando il codice effettua chiamate all'API.
Contatta DV360 con le informazioni del service account che hai creato, in particolare l'indirizzo email del service account. Questa operazione fa parte della procedura di lista consentita per l'accesso all'API.
Token di accesso
Dopo che il tuo account di servizio è autorizzato a effettuare chiamate all'API, puoi procedere con gli esempi nelle guide all'API. Per ottenere manualmente un token di accesso, puoi utilizzare uno strumento come oauth2l oppure una delle nostre librerie client per eseguire l'autenticazione a livello di programmazione.