Configurare l'accesso API

Ecco come configurare l'accesso all'API Data Manager con un SDK o REST.

Prerequisiti

Prima di poter utilizzare l'API Data, assicurati di avere quanto segue:

  1. Un progetto Google Cloud. Puoi utilizzare un progetto esistente o crearne uno nuovo appositamente per l'API Data Manager.

  2. Un Account Google con l'autorizzazione serviceusage.services.enable per il tuo progetto Google Cloud o con un ruolo che include questa autorizzazione. Ad esempio, roles/owner e roles/serviceusage.serviceUsageAdmin includono entrambi l'autorizzazione serviceusage.services.enable. Per controllare le tue autorizzazioni, consulta Visualizzare l'accesso attuale.

  3. Google Cloud CLI installato.

Abilita l'API

Se non l'hai ancora fatto, abilita l'API Data Manager facendo clic su Abilita l'API Data Manager o segui le istruzioni per eseguire questo passaggio manualmente.

Abilita l'API Data Manager

Se non riesci a trovare l'API Data Manager o Abilita l'API Data Manager non funziona, verifica che il tuo Account Google soddisfi i prerequisiti.

Configura l'autenticazione

Puoi utilizzare uno dei metodi di autenticazione di Google, oltre alle chiavi API. Ti consigliamo di esaminare la procedura per scegliere il metodo di autenticazione giusto per il tuo caso d'uso per decidere quale approccio è appropriato.

Due metodi di autenticazione comuni sono gli account utente e i service account:

  • Account utente: rappresentano le persone che interagiscono direttamente con le API di Google e i servizi Google.
  • Service account: rappresentano le app, non le persone, come utenti. Consentono alle tue app di gestire l'autenticazione e l'autorizzazione. Ad esempio, se un'app deve accedere alle risorse Google Cloud.

La tua integrazione può utilizzare Credenziali predefinite dell'applicazione (ADC) per trovare automaticamente le credenziali dall'ambiente, in modo da non dover modificare il codice client per l'autenticazione.

Scegli Account utente o Service account per configurare le ADC:

Account utente

Ecco i passaggi per l'autenticazione con credenziali dell'account utente:

  1. Configura le impostazioni della piattaforma di autenticazione Google per il tuo progetto.

    1. Apri la pagina Branding in console Google Cloud.

    2. Seleziona il progetto.

    3. Compila il modulo e fai clic su Crea.

  2. Poiché l'ambito dell'API Data Manager è un ambito sensibile, sono necessari i seguenti passaggi:

    1. Vai alle impostazioni di accesso ai dati per il tuo progetto.

    2. Fai clic su Aggiungi o rimuovi ambiti.

    3. Seleziona la casella accanto a API Data Manager nell'elenco degli ambiti e fai clic su Aggiorna.

    4. Fai clic su Salva.

    5. Vai a Pubblico in console Google Cloud e aggiorna lo stato di pubblicazione e il tipo di utente. Scopri di più su queste impostazioni in Gestire il pubblico dell'app.

  3. Fai clic su Crea client OAuth2 per creare un client OAuth2 nel progetto o segui le istruzioni per creare un client OAuth2 desktop. Puoi saltare questo passaggio se hai già un client OAuth2 desktop che vuoi utilizzare per l'API Data Manager.

    Se fai clic su Crea client OAuth2, seleziona App desktop quando ti viene chiesto di configurare il client OAuth in modo da poter utilizzare il client in i passaggi rimanenti.

    Crea client OAuth2

    Nell'ultimo passaggio, fai clic su SCARICA CONFIGURAZIONE CLIENT e prendi nota della posizione di download scelta.

  4. Genera un file ADC locale eseguendo il seguente comando. Questo comando avvia un flusso web in cui ti viene chiesto di accedere all'Account Google che utilizzi con l'API.

    Sostituisci PATH_TO_CLIENT_JSON con il nome del file JSON che hai scaricato.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Se vuoi utilizzare le stesse credenziali per l'API Data Manager e l' API Google Ads, includi l'ambito dell'API Google Ads nell'elenco --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Se vuoi utilizzare le stesse credenziali per l'API Data Manager e l' API Display & Video 360, includi l'ambito dell'API Display & Video 360 nell'elenco --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Verifica che le credenziali siano configurate correttamente utilizzando il seguente comando. In caso di esito positivo, il comando stampa un token di accesso nella console.

    gcloud auth application-default print-access-token

Service account

Ecco i passaggi per utilizzare la rappresentazione del service account per l'autenticazione. Questi passaggi utilizzano la rappresentazione anziché le chiavi del service account perché le chiavi del service account possono diventare un rischio per la sicurezza se non vengono gestite con attenzione.

  1. Fai clic sul seguente pulsante Crea service account o segui le istruzioni per selezionare o creare un service account.

    Crea service account

  2. Concedi al service account il ruolo IAM Consumer di Service Usage (roles/serviceusage.serviceUsageConsumer), che include l' autorizzazioneserviceusage.services.use che consente al service account di inviare richieste API per il progetto.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. Concedi al tuo Account Google il ruolo IAM Creatore token account di servizio (roles/iam.serviceAccountTokenCreator) nel service account.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. Configura le ADC eseguendo il seguente comando:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    Se vuoi utilizzare le stesse credenziali per l'API Data Manager e l' API Google Ads, includi l'ambito dell'API Google Ads nell'elenco --scopes:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    Se vuoi utilizzare le stesse credenziali per l'API Data Manager e l' API Display & Video 360, includi l'ambito dell'API Display & Video 360 nell'elenco --scopes:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    Quando ti viene chiesto di accedere, accedi con il tuo Account Google che ha il ruolo Creatore token account di servizio.

  5. Verifica che le credenziali siano configurate correttamente utilizzando il seguente comando. In caso di esito positivo, il comando stampa un token di accesso nella console.

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

Per saperne di più sull'autenticazione e sulle credenziali per la tua app, consulta Metodi di autenticazione di Google e Come funzionano le Credenziali predefinite dell'applicazione.

Configura l'accesso all'account

Account utente

Concedi all'indirizzo email associato all'utente l'accesso a Destination.

  • Se utilizzi un account Google Ads, segui le istruzioni per aggiungere l'indirizzo email dell'utente all'account Google Ads o a un account amministratore Google Ads principale.
  • Se utilizzi un account Display & Video 360, segui le istruzioni per aggiungere l'indirizzo email dell'utente all'account.
  • Se utilizzi una proprietà Google Analytics, segui le istruzioni per aggiungere l'indirizzo email dell'utente all'account.
  • Se accedi al Destination utilizzando un account partner di dati con un link partner dall'account inserzionista, segui le istruzioni per aggiungere l'indirizzo email dell'utente all'account partner di dati.

Service account

Concedi all'indirizzo email associato al tuo service account l'accesso a Destination.

  • Se utilizzi un account Google Ads, completa la configurazione dell'accesso all'account per aggiungere il service account all'account Google Ads o a un account amministratore Google Ads principale.
  • Se utilizzi un account Display & Video 360, segui le istruzioni per creare un utente Display & Video 360 associato al service account.
  • Se utilizzi una proprietà Google Analytics, segui le istruzioni per aggiungere l'indirizzo email dell'utente all'account.
  • Se accedi al Destination utilizzando un account partner di dati con un link partner dall'account inserzionista, completa la configurazione dell'accesso all'account nell'account partner di dati per aggiungere il service account e impostarne il livello di accesso.

Passaggi successivi

Installa una libreria client ed esegui esempi di codice per provare la tua prima richiesta API Data Manager.

Avanti
Installa una libreria client