Gestione accesso utenti

In qualità di amministratore, puoi gestire i livelli di accesso e i ruoli utente per i tuoi account Google Ads. Puoi recuperare e aggiornare i ruoli utente, inviare inviti agli utenti e terminare l'accesso di un utente a un account utilizzando l'API Google Ads. Scopri di più sui livelli di accesso all'account.

Per gestire l'accesso utente, l'utente o il service account chiamante deve disporre dell'accesso ADMIN all'account di destinazione.

Invita utenti

Per invitare un nuovo utente ad accedere a un account, utilizza CustomerUserAccessInvitationService per creare e inviare un invito (vedi Gestire gli inviti di accesso utente). Una volta che l'utente accetta l'invito, viene visualizzato come utente confermato in CustomerUserAccess.

Recuperare i ruoli utente

Puoi ottenere l'elenco degli utenti con accesso a un account creando un'istruzione Google Ads Query Language per eseguire query su tutte le entità CustomerUserAccess associate a un ID cliente. Ecco una query tipica:

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

Modificare i ruoli utente

Per aggiornare un ruolo utente esistente, chiama CustomerUserAccessService.MutateCustomerUserAccess utilizzando l'operazione UPDATE. Quando modifichi un ruolo utente, devi fornire:

• Il nome risorsa dell'entità CustomerUserAccess da modificare, nel formato customers/{customer_id}/customerUserAccesses/{user_id}.
• Il nuovo ruolo utente in access_role.
• Un update_mask (FieldMask) che specifica access_role.

Rimuovi utenti

Per terminare l'accesso di un utente all'account, chiama CustomerUserAccessService.MutateCustomerUserAccess con un'operazione REMOVE che specifica il nome della risorsa (customers/{customer_id}/customerUserAccesses/{user_id}).

Approvazione da più parti per le modifiche all'accesso

Se viene attivata una richiesta di approvazione da più parti durante la chiamata MutateCustomerUserAccess:

• L'oggetto MutateCustomerUserAccessResult (contenuto nel campo result di MutateCustomerUserAccessResponse) compilerà il campo multi_party_auth_review con il nome della risorsa della revisione in attesa che richiede l'approvazione.
• Il campo resource_name in MutateCustomerUserAccessResult non verrà compilato.
• La richiesta di revisione in attesa può essere approvata o rifiutata da un secondo amministratore utilizzando il metodo MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Per saperne di più, consulta la guida all'approvazione da più parti.