Onboarding e configurazione di OAuth per l'API Exchange Reporting di DV360

L'API di reporting di Exchange DV360 è esposta come Google Cloud basata su lista consentita che utilizza OAuth. La procedura di inserimento nella lista consentita è gestita dalla piattaforma di scambio pubblicitario DV360 dell'API di reporting.

Procedura

Ecco i passaggi di onboarding dell'API Exchange Reporting DV360:

  1. Registra un Account Google su Google Cloud Google Cloud.

    Tieni presente che questo account deve essere utilizzato per gestire i token di accesso per i tuoi di produzione, quindi non usare il tuo account Gmail personale.

  2. Contatta Google DV360 con i dati dell'account per aggiungerli al nella lista consentita.

  3. Dopo aver ricevuto una notifica che ti informa che sei nella lista consentita, richiedi un OAuth revisione della verifica per consentire alla tua app di accedere all'ambito doubleclickbidmanager.

  4. Accedi alla console Google Cloud.

    Vai ad API e Servizi > Raccolta > Privata. Dovresti vedere un'immagine DV360 L'API Exchange Reporting è indicata come una delle API a tua disposizione. Attiva il l'API Exchange Reporting di DV360.

  5. Vai a Credenziali > Crea una credenziale > Chiave account di servizio. Segui le istruzioni per creare un servizio Google Cloud.

Account di servizio

Un account di servizio consente al tuo codice di inviare le credenziali dell'applicazione direttamente l'API. Un account di servizio, ad esempio un account utente, è rappresentato da un indirizzo email . A differenza di un account utente, tuttavia, un account di servizio appartiene solo a un e può essere utilizzato solo per accedere all'API per cui è stata creata.

Ecco i passaggi per creare le credenziali dell'account di servizio utilizzando Google Cloud Console:

  1. Dal Gestore API > Credenziali, seleziona Crea credenziali→Chiave account di servizio.

  2. Seleziona Nuovo account di servizio dal menu a discesa Account di servizio.

    Inserisci un nome per questo account di servizio. Questo nome è utilizzato come predefinito del tuo ID account di servizio, a sinistra di @ nella l'indirizzo ID dell'account di servizio generato.

    In Tipo di chiave, ti consigliamo di lasciare questo valore su JSON. Clic Crea per generare una chiave JSON come file di testo .json. Quando richiesto, scarica il file sul tuo computer e visualizza una finestra di dialogo Account di servizio creato. .

    Ecco una chiave JSON di esempio:

    {
  "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"
}

  3. Archivia il file JSON in modo sicuro, poiché contiene la tua chiave privata, e questo è l'unica copia di quella chiave. Le credenziali in questo file sono necessarie quando il codice effettua chiamate all'API.

  4. Contatta DV360 con le informazioni dell'account di servizio che hai creato. in particolare, l'indirizzo email dell'account di servizio. Fa parte del Procedura di inserimento nella lista consentita per l'accesso all'API.

Token di accesso

Dopo che il tuo account di servizio è stato autorizzato a effettuare chiamate all'API, puoi: procedi con gli esempi nelle guide dell'API. Per ottenere manualmente un token di accesso, puoi usare uno strumento come oauth2l; oppure usa uno del nostro cliente librerie per eseguire l'autenticazione programmatica.