Flusso di lavoro del service account

Questa guida illustra come accedere all'API Google Ads con i service account.

Un service account è un account che appartiene alla tua app anziché a un singolo utente finale. I service account utilizzano un flusso OAuth 2.0 che non richiede l'autorizzazione umana, ma un file chiave accessibile solo alla tua app.

L'utilizzo dei service account offre due vantaggi principali:

• L'autorizzazione per l'accesso all'API Google Ads agli account Google Ads viene eseguita come passaggio di configurazione, sfruttando le funzionalità di autorizzazione e gestione degli account offerte dall'interfaccia utente Google Ads. In questo modo, gli sviluppatori non devono creare flussi OAuth 2.0 e gestire le complicazioni che comportano l'interazione con l'utente, l'archiviazione delle credenziali utente e la gestione dei token.

• L'autorizzazione per l'accesso agli account Google Ads non è legata alle credenziali del singolo utente, il che può essere utile nei casi in cui si prevede che l'autorizzazione continui anche se il dipendente che ha autorizzato originariamente l'accesso lascia il team o l'azienda.

Configurazione dell'accesso all'account

1. Inizia creando un service account e le credenziali.

   Scarica la chiave del service account in formato JSON e annota l'ID e l'email del service account.

2. Accedi al tuo account Google Ads come amministratore. Vai ad Amministratore > Accesso e sicurezza.

3. Fai clic sul pulsante + nella scheda Utenti.

4. Digita l'email del service account nella casella di input Email. Seleziona il livello di accesso all'account appropriato (tieni presente che i service account non supportano il livello di accesso Solo email) e fai clic sul pulsante Aggiungi account.

5. Al service account viene concesso l'accesso.

6. (Facoltativo) Per impostazione predefinita, non puoi concedere l'accesso amministratore a un service account. Segui il principio del privilegio minimo e concedi l'accesso amministrativo solo se le chiamate API lo richiedono. Puoi eseguire l'upgrade dell'accesso nel seguente modo:

   • Fai clic sulla freccia del menu a discesa accanto al livello di accesso dell'account di servizio nella colonna Livello di accesso.
   • Seleziona Amministratore dall'elenco a discesa.

Configurazione della libreria client

Seleziona la scheda corrispondente al tuo linguaggio di programmazione per istruzioni su come configurare la libreria client. Se il tuo account di servizio accede agli account cliente tramite un account amministratore Google Ads (Centro clienti), imposta anche login-customer-id (o loginCustomerId) sull'ID cliente di 10 cifre di quell'account amministratore senza trattini (vedi ID cliente di accesso).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
    // ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=JSON_KEY_FILE_PATH

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST \
  https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}