Flusso di lavoro del service account

Questa guida spiega 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 utilizza un file chiave accessibile solo dalla 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 dalla UI di 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 dei singoli utenti, il che può essere utile nei casi in cui si prevede che l'autorizzazione continui anche se il dipendente che ha autorizzato l'accesso originariamente 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 prendi nota dell'ID e dell'indirizzo 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'indirizzo email del service account nella casella di immissione 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.

   Al service account viene concesso l'accesso.

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

   • Fai clic sulla freccia menu a discesa accanto al livello di accesso del service account 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 service account accede agli account cliente tramite un account amministratore Google Ads, imposta anche login-customer-id (o loginCustomerId) sull'ID cliente di 10 cifre dell'account amministratore senza trattini (consulta 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/v26/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"
}