Configurazione dell'autorizzazione

Onboarding dell'API Display &Video 360 Seller

Esistono alcuni passaggi chiave per l'onboarding con l'API Display &Video 360 Seller. L'API DV360 Seller è un'API Google Cloud basata su lista consentita e utilizza OAuth 2.0 per l'autenticazione e l'autorizzazione.

La procedura di inserimento nella lista consentita viene gestita dal team dell'API Display &Video 360 Seller.

Passaggi per l'onboarding:

  1. Registrati per un Account Google visitando la pagina https://console.cloud.google.com/.
    • Questo account verrà utilizzato per gestire i token di accesso per il client di produzione. Non utilizzare un 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 il team di Google DV360 con i dettagli del tuo account per aggiungerlo alla lista consentita.
  3. Attendi la conferma che il tuo account è stato attivato.
  4. Facoltativo e non bloccante: invia una richiesta di revisione di verifica OAuth per la tua applicazione per accedere all'ambito https://www.googleapis.com/auth/doubleclickbidmanager.
  5. Nella console Google Cloud, vai ad API e servizi > Libreria > Privato. Dovresti vedere l'API DV360 Seller disponibile per il tuo progetto.
  6. Attiva l'API DV360 Seller.
  7. Vai ad API e servizi > Credenziali > Crea credenziali > Chiave dell'account di servizio. Segui le istruzioni di configurazione nella documentazione relativa all'account di servizio OAuth 2.0.

    Configura un account di servizio:

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

    L'autenticazione e l'autorizzazione delle API Google Cloud (comunemente 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 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. Ad esempio, mostreremo come creare le credenziali dell'account di servizio utilizzando la console Google Cloud Platform.

    Utilizzo della console Google Cloud

    Nella pagina Gestione API → Credenziali di Google Cloud Console, seleziona "Crea credenziali → Chiave dell'account di servizio".

    alt_text

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

    alt_text

    Digita un "Nome" per questo account di servizio. Questo nome verrà utilizzato come nome predefinito per l'"ID service account" (a sinistra della "@" nell'indirizzo ID service account generato), ma puoi modificare questo nome ID service account, se vuoi. Questi nomi possono essere arbitrari; l'importante è che tu li ricordi. Nella sezione "Tipo di chiave", ti consigliamo di lasciare questo valore su "JSON". Fai clic su "Crea" e la console GCP 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.

    alt_text

    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>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 questo file JSON in modo sicuro, poiché 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 nel codice quando vuoi inviare le credenziali all'API Google Cloud Platform.

  8. Contatta il team di DV360 con le informazioni dell'account di servizio che hai creato (in particolare, l'indirizzo email dell'account di servizio). Questo è un secondo passaggio di inserimento nella lista consentita per l'autorizzazione.
  9. Una volta che il tuo service account è autorizzato a chiamare l'API, puoi consultare la documentazione dell'API DV360 Seller. Per ottenere manualmente un token di autenticazione, consulta le istruzioni nel repository dello strumento oauth2l (utilizzando la chiave del service account JSON scaricata). Istruzioni dettagliate su come ottenere i token OAuth a livello di programmazione sono disponibili nella documentazione sull'autenticazione di Google Cloud.

Importante: l'ambito OAuth deve essere https://www.googleapis.com/auth/doubleclickbidmanager

Indietro
Panoramica
Avanti
Libreria client