Configurare l'accesso API

Account utente

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

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

   1. Apri la pagina Branding nella console Google Cloud.

   2. Seleziona il progetto.

   3. Compila il modulo e fai clic su Crea.

2. Poiché l'API Data Manager utilizza ambiti sensibili, 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. Nell'elenco degli ambiti, trova API Data Manager e seleziona la casella per ogni ambito richiesto dalla tua applicazione:

      • .../auth/datamanager: seleziona questo ambito per le operazioni API standard, come la gestione dei dati dei clienti, dei segmenti di pubblico e degli eventi. Questo è l'ambito principale utilizzato in questa guida.

      • .../auth/datamanager.partnerlink: seleziona questo ambito solo se sei un partner di dati che crea o elimina link partner negli account inserzionista.

   4. Fai clic su Aggiorna.

   5. Fai clic su Salva.

   6. Vai a Segmenti di pubblico in nella console Google Cloud e configura le impostazioni per lo sviluppo iniziale:

      • Imposta Stato della pubblicazione su Test.
      • Imposta Tipo di utente su Interno (se il tuo progetto si trova in un'organizzazione Google Workspace) o Esterno (in caso contrario).
      • Se utilizzi Esterno, aggiungi gli Account Google che utilizzi per generare le credenziali come Utenti di test.

      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 che hai scelto.

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 creare un service account e utilizzare la simulazione dell'identità del service account per l'autenticazione in un ambiente di sviluppo locale. Questi passaggi utilizzano la simulazione dell'identità anziché le chiavi del service account perché le chiavi del service account possono diventare un rischio per la sicurezza se non 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 Service Usage Consumer (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 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"
   

Account utente

Seleziona la scheda corrispondente al tuo caso d'uso.

• Seleziona Inserzionista se utilizzi le credenziali per un Account Google che è un utente negli account inserzionista che vuoi gestire.
• Seleziona Partner di dati se utilizzi le credenziali per un Account Google che è un utente in un account partner di dati e vuoi gestire gli account inserzionista che hanno un link partner all'account partner di dati. Gli account partner di dati vengono emessi solo dopo aver completato la procedura di approvazione. Per iniziare, compila il modulo di interesse.

Service account

Seleziona la scheda corrispondente al tuo caso d'uso.

• Seleziona Inserzionista se utilizzi le credenziali per un Account Google che è un utente negli account inserzionista che vuoi gestire.
• Seleziona Partner di dati se utilizzi le credenziali per un Account Google che è un utente in un account partner di dati e vuoi gestire gli account inserzionista che hanno un link partner all'account partner di dati. Gli account partner di dati vengono emessi solo dopo aver completato la procedura di approvazione. Per iniziare, compila il modulo di interesse.