Configurare l'accesso API

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

Scegli il tipo di procedura di configurazione che vuoi seguire:

Prerequisiti

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

  1. Un progetto Google Cloud.
  2. Un Account Google con l'autorizzazione serviceusage.services.enable sul 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. L'interfaccia a riga di comando Google Cloud installata.

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 l'abilitazione dell'API Data Manager non va a buon fine, verifica che il tuo Account Google soddisfi i prerequisiti.

Configura l'autenticazione

Puoi utilizzare uno qualsiasi dei metodi di autenticazione di Google, ad eccezione delle chiavi API. Ti consigliamo di esaminare la sezione Scegliere il metodo di autenticazione giusto per il tuo caso d'uso per decidere quale approccio è più adatto al tuo caso d'uso.

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

  • Account utente: rappresentano le persone che interagiscono direttamente con le API e i servizi Google.
  • Service account: rappresentano app, non 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.

L'integrazione può utilizzare le 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 Simulazione dell'identità del service account per configurare ADC:

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

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

    1. Apri la pagina Brand nella 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 nella console Google Cloud e aggiorna lo Stato di pubblicazione e il Tipo di utente. Scopri di più su queste impostazioni in Gestisci 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 poterlo utilizzare nei passaggi successivi.

    Crea il client OAuth2

    Nell'ultimo passaggio, fai clic su SCARICA CONFIGURAZIONE CLIENT e annota la posizione di download che scegli.

  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

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.

Configurare l'accesso all'account

Concedi all'email associata al tuo account utente l'accesso a Destination.

  • Se utilizzi un account Google Ads, segui le istruzioni per aggiungere l'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'email dell'utente all'account.
  • Se utilizzi una proprietà Google Analytics, segui le istruzioni per aggiungere l'email dell'utente all'account.

Passaggi successivi

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

Avanti
Installa una libreria client