Gerenciar o acesso dos usuários

Como administrador, você pode gerenciar os níveis de acesso e as funções dos usuários nas suas contas do Google Ads. É possível recuperar e atualizar as funções dos usuários, enviar convites e encerrar o acesso de um usuário a uma conta usando a API Google Ads. Saiba mais sobre os níveis de acesso da conta.

Para gerenciar o acesso do usuário, a conta de serviço ou o usuário que faz a chamada precisa ter acesso ADMIN à conta de destino.

Convidar usuários

Para convidar um novo usuário a acessar uma conta, use o CustomerUserAccessInvitationService para criar e enviar um convite (consulte Gerenciar convites de acesso do usuário). Depois que o usuário aceitar o convite, ele vai aparecer como um usuário confirmado em CustomerUserAccess.

Recuperar funções de usuário

Você pode acessar a lista de usuários com acesso a uma conta criando uma instrução da linguagem de consulta do Google Ads para consultar todas as entidades CustomerUserAccess associadas a um ID de cliente. Confira uma consulta típica:

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

Modificar funções de usuário

Para atualizar uma função de usuário, chame CustomerUserAccessService.MutateCustomerUserAccess usando a operação UPDATE. Ao modificar uma função de usuário, você precisa fornecer:

• O nome do recurso da entidade CustomerUserAccess a ser modificada, no formato customers/{customer_id}/customerUserAccesses/{user_id}.
• A nova função de usuário em access_role.
• Uma update_mask (FieldMask) especificando access_role.

Remover usuários

Para encerrar o acesso de um usuário à conta, chame CustomerUserAccessService.MutateCustomerUserAccess com uma operação REMOVE especificando o nome do recurso (customers/{customer_id}/customerUserAccesses/{user_id}).

Aprovação de várias partes para mudanças de acesso

Se um pedido de aprovação de várias partes for acionado ao chamar MutateCustomerUserAccess:

• O objeto MutateCustomerUserAccessResult (contido no campo result de MutateCustomerUserAccessResponse) vai preencher o campo multi_party_auth_review com o nome do recurso da análise pendente que exige aprovação.
• O campo resource_name em MutateCustomerUserAccessResult não será preenchido.
• A solicitação de análise pendente pode ser aprovada ou rejeitada por um segundo administrador usando o MultiPartyAuthReviewService.ResolveMultiPartyAuthReview método. Consulte o guia de aprovação de várias partes para saber mais.