Gestione accesso utenti

In qualità di amministratore, puoi gestire i livelli di accesso e i ruoli degli utenti per i tuoi account Google Ads. Puoi recuperare e aggiornare i ruoli utente, inviare inviti agli utenti e revocare 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 degli utenti, 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 la CustomerUserAccessInvitationService per creare e inviare un invito (consulta Gestisci gli inviti di accesso degli utenti). Una volta accettato l'invito, l'utente verrà visualizzato come utente confermato in CustomerUserAccess.

Recupera 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

Nota: l'esecuzione di query su customer_user_access restituisce solo gli utenti confermati. Gli inviti in attesa possono essere interrogati utilizzando customer_user_access_invitation.

Se una modifica del livello di accesso utente è in attesa di un'approvazione da più parti, non verrà visualizzata quando recuperi gli elenchi per gli accessi utente utilizzando il metodo GoogleAdsService.Search o GoogleAdsService.SearchStream.

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

Nota: l'API rifiuterà le richieste di downgrade dell'ultimo utente ADMIN di un account amministratore (CustomerUserAccessError.LAST_ADMIN_USER_OF_MANAGER) o di un account di pubblicazione attivo che non ha un amministratore proprietario (CustomerUserAccessError.LAST_ADMIN_USER_OF_SERVING_CUSTOMER).

Rimuovi utenti

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

Nota: come per i downgrade dei ruoli, l'API rifiuta le richieste di rimozione dell'ultimo utente ADMIN in un account amministratore (LAST_ADMIN_USER_OF_MANAGER) o in un account di pubblicazione attivo senza un amministratore proprietario (LAST_ADMIN_USER_OF_SERVING_CUSTOMER).

Approvazione da più parti per le modifiche di accesso

Nota: l'API Google Ads potrebbe generare una richiesta di approvazione da più parti quando modifichi o rimuovi i ruoli utente. Per saperne di più, consulta la guida all'approvazione da più parti.

Se viene attivata una richiesta di approvazione da più parti quando chiami MutateCustomerUserAccess:

• L'oggetto MutateCustomerUserAccessResult (contenuto nel campo result di MutateCustomerUserAccessResponse) compila 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.