Informazioni sul modello di accesso a Google Ads

Esistono due tipi di account Google Ads: account amministratore Google Ads e account inserzionista Google Ads (noti anche come account cliente). Gli account amministratore possono gestire altri account amministratore Google Ads o account inserzionista Google Ads. Puoi collegare un account inserzionista a un account amministratore e poi gestire l'account inserzionista tramite l'account amministratore. La struttura collegata complessiva è un grafo aciclico diretto con gli account inserzionista a livello di foglia.

Puoi concedere l'accesso agli account Google Ads a singoli utenti o account di servizio. Esistono due modi per concedere agli utenti l'accesso a un account inserzionista:

• Concedi all'utente l'accesso diretto all'account inserzionista invitandolo a questo account.
• Concedi all'utente l'accesso indiretto all'account inserzionista invitandolo a un account amministratore collegato a quell'account. L'utente ottiene l'accesso all'account inserzionista poiché l'account amministratore ha accesso a tutti gli account collegati.

Puoi anche assegnare ruoli utente quando inviti un utente a gestire un account.

Considera la seguente gerarchia dell'account. Supponi che tutti gli utenti abbiano accesso standard.

La seguente tabella riepiloga questa struttura dell'account.

Utente	Ha accesso diretto a	Ha accesso indiretto a
U1, SA1	M1	M2, A1, A2, A3
U2	M2, M3	A1, A2, A3, A4
U3	A4

ID cliente di accesso

Un utente può avere accesso a più gerarchie di account. Quando effettui una chiamata API in questi casi, devi specificare l'account principale da utilizzare per determinare correttamente i livelli di autorizzazione e accesso all'account. A questo scopo, specifica un'intestazione login-customer-id nell'ambito della richiesta API.

La tabella seguente utilizza la gerarchia dell'account dell'esempio precedente per mostrare gli ID cliente di accesso che puoi utilizzare e l'elenco corrispondente di account a cui puoi effettuare chiamate.

Utente	ID cliente di accesso da utilizzare	Account per effettuare chiamate API
U1, SA1	M1	M1, M2, A1, A2, A3
U2	M2	M2, A1, A2, A3
U2	M3	M3, A1, A4
U3	A4	A4

Puoi saltare la fornitura dell'intestazione login-customer-id se l'utente ha accesso diretto all'account Google Ads a cui stai effettuando chiamate. Ad esempio, non devi specificare l'intestazione login-customer-id quando utilizzi le credenziali U3 per effettuare una chiamata a A4, poiché i server Google Ads possono determinare correttamente il livello di accesso dall'ID cliente (A4).

Se utilizzi una delle nostre librerie client, utilizza le seguenti impostazioni per specificare l'intestazione login-customer-id.

Java

Aggiungi la seguente impostazione al file ads.properties.

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

C#

Aggiungi la seguente impostazione quando inizializzi l'oggetto GoogleAdsConfig e utilizzalo per creare un oggetto GoogleAdsClient.

GoogleAdsConfig config = new GoogleAdsConfig()
{
    ...
    LoginCustomerId = ******
};
GoogleAdsClient client = new GoogleAdsClient(config);

PHP

Aggiungi la seguente impostazione al file google_ads_php.ini.

[GOOGLE_ADS]
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

Python

Aggiungi la seguente impostazione al file google-ads.yaml.

login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE

Ruby

Aggiungi la seguente impostazione al file google_ads_config.rb.

Google::Ads::GoogleAds::Config.new do |c|
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
end

Crea un'istanza GoogleAdsClient passando il percorso in cui conservi questo file.

client = Google::Ads::GoogleAds::GoogleAdsClient.new('path/to/google_ads_config.rb')

Perl

Aggiungi la seguente impostazione al file googleads.properties.

loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

curl

Specifica il seguente argomento della riga di comando quando esegui il comando curl.

-H "login-customer-id: LOGIN_CUSTOMER_ID"

Ruoli utente

L'API Google Ads non ha un proprio modello di accesso separato né utilizza ambiti OAuth 2.0 separati per limitare la funzionalità. Ad esempio, l'API Google Ads utilizza gli stessi ambiti per le operazioni di sola lettura e lettura/scrittura. L'API Google Ads segue gli stessi ruoli utente supportati da Google Ads. Quando un ruolo utente viene concesso a un account a livello di amministratore, il ruolo viene ereditato dagli account nella gerarchia. Se un utente ha ruoli in conflitto per un determinato account, il livello corretto viene risolto dall'account login-customer-id specificato nella richiesta API.

La tabella seguente utilizza la gerarchia degli account dell'esempio precedente e mostra l'effetto della concessione di vari ruoli utente agli utenti.

Utente	Ruolo utente concesso	login-customer-id	Livello di accesso effettivo
SA1	Accesso standard all'account M1	M1	Accesso standard su M1, M2, A1, A2, A3
U2	Accesso standard su M2 Accesso in sola lettura su M3	M2	Accesso standard su M2, A1, A2, A3
U2	Accesso standard su M2 Accesso in sola lettura su M3	M3	Accesso in sola lettura su M3, A1, A4