Configurazione dell'autorizzazione

Onboarding dell'API DV360 Seller

Esistono alcuni passaggi principali per integrare un'API per l'API DV360 Seller. L'API DV360 Seller è esposta come API Google Cloud basata su lista consentita e utilizza OAuth per l'autenticazione.

La procedura di inserimento nella lista consentita verrà gestita contattando il team dell'API DV360 Seller.

Nota: se la tua app accede all'API DV360 Seller, deve superare la revisione di verifica OAuth. Se sullo schermo viene visualizzata la dicitura App non verificata durante il test dell'app, devi inviare una richiesta di verifica per rimuoverla. Scopri di più sulle app non verificate o trova le risposte alle domande frequenti sulla verifica delle app.

Passaggi per l'onboarding:

1. Registra un Account Google all'indirizzo https://console.cloud.google.com/.
   • Questo account verrà utilizzato per gestire i token di accesso per il client di produzione. Non utilizzare il tuo account Gmail personale.
   • L'account non può essere un gruppo Google.
   • Se utilizzi un progetto Google Cloud esistente: l'account deve essere un amministratore del progetto.
2. Contatta Google DV360 con i dati dell'account con cui hai effettuato la registrazione per chiedere di aggiungerlo alla lista consentita.
3. Attendi che il tuo account venga aggiunto all'elenco consentiti.
4. Facoltativo e non bloccante:invia una richiesta di revisione della verifica OAuth per la tua app per accedere all'ambito(doubleclickbidmanager).
5. Vai alla pagina https://console.cloud.google.com/. Vai ad API e servizi -> Libreria -> Privata. Dovresti riuscire a vedere l'API DV360 Seller elencata come una delle API a tua disposizione.
6. Attivare l'API DV360 Seller
7. Vai a Credenziali -> Crea una credenziale -> Chiave dell'account di servizio. Segui le istruzioni riportate qui: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

   Configura un account di servizio:

   Nota:comunicaci se vuoi riutilizzare un account di servizio esistente, ad esempio per l'API DV360 Reporting.

   L'autenticazione e l'autorizzazione dell'API Google Cloud (in genere raggruppate come "autenticazione") vengono in genere eseguite utilizzando un account di servizio. Un account di servizio consente al codice di inviare le credenziali dell'applicazione direttamente all'API Cloud. Un account di servizio, come un account utente, è rappresentato da un indirizzo email. Tuttavia, a differenza di un account utente, un account di servizio appartiene solo a un'applicazione e può essere utilizzato solo per accedere all'API per cui è stato creato. Ad esempio, mostreremo come creare le credenziali dell'account di servizio utilizzando la console della piattaforma Google Cloud.

   Utilizzo di Google Cloud Console

   Nella pagina Gestione API→Credenziali della console Google Cloud, seleziona "Crea credenziali→Chiave account di servizio".

   

   Quindi, seleziona "Nuovo account di servizio" dal menu a discesa "Account di servizio".

   

   Digita un "Nome" per questo account di servizio. Questo nome verrà utilizzato come nome predefinito per l'"ID account di servizio" (a sinistra dell'"@" nell'indirizzo dell'ID account di servizio generato), ma puoi modificarlo se vuoi. Questi nomi possono essere arbitrari; è importante solo che tu li ricordi. In "Tipo di chiave", ti consigliamo di lasciare il valore "JSON". Fai clic su "Crea" e la Console Google Cloud genererà una chiave JSON (come file di testo .json), ti chiederà di scaricare il file sul computer e visualizzerà una finestra di dialogo Account di servizio creato.

   

   La chiave JSON generata sarà simile alla seguente 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>[e-mail]",
     "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 questo file JSON in modo sicuro, in quanto contiene la tua chiave privata (e questo file è l'unica copia di questa chiave). Dovrai fare riferimento a questo file della chiave dell'account di servizio all'interno del codice quando vuoi inviare le credenziali all'API Google Cloud.

8. Contatta DV360 fornendo le informazioni sull' account di servizio che hai creato. Nello specifico, avremo bisogno dell'indirizzo email di questo account di servizio. Questa è un'altra procedura di lista consentita per l'autorizzazione.
9. Una volta che il tuo account di servizio è autorizzato a chiamare l'API, puoi consultare la pagina https://developers.google.com/display-video/seller per la documentazione dell'API. Per ottenere il token di autenticazione manualmente, consulta le istruzioni qui: https://github.com/google/oauth2l. Devi aver già scaricato la versione JSON della chiave dell'account di servizio. Qui puoi trovare anche istruzioni dettagliate su come ottenere il token OAuth in modo programmatico: https://cloud.google.com/docs/authentication/production.

Importante: l'ambito OAuth deve essere "doubleclickbidmanager"