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).
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 |