Gerenciar o acesso do usuário

Como administrador, você pode gerenciar os níveis de acesso e as funções dos usuários nas suas contas do Google Ads. A API Google Ads pode recuperar e atualizar as funções dos usuários, além de encerrar o acesso deles a uma conta. Saiba mais sobre os níveis de acesso da conta.

Recuperar funções de usuários

Para acessar a lista de usuários com acesso a uma conta, crie uma instrução da linguagem de consulta do Google Ads para consultar todas as entidades CustomerUserAccess associadas a um ID de cliente. Confira um exemplo de consulta:

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ários

Para atualizar uma função de usuário, chame CustomerUserAccessService.MutateCustomerUserAccess. Use a operação UPDATE e forneça o nome do recurso CustomerUserAccess a ser modificado, bem como a nova função do usuário.

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

• O MutateCustomerUserAccessResponse será preenchido com o nome do recurso da análise pendente que exige aprovação no campo multi_party_auth_review.
• O campo resource_name não será preenchido.
• O pedido de análise pendente pode ser aprovado ou rejeitado por um segundo administrador usando o MultiPartyAuthReviewService.ResolveMultiPartyAuthReview método. Consulte o guia de aprovação de várias partes para saber mais.

Remover usuários

Para encerrar o acesso de um usuário à conta, chame CustomerUserAccessService.MutateCustomerUserAccess com uma operação REMOVE.

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

• O MutateCustomerUserAccessResponse será preenchido com o nome do recurso da análise pendente que exige aprovação no campo multi_party_auth_review.
• O campo resource_name não será preenchido.
• O pedido de análise pendente pode ser aprovado ou rejeitado por um segundo administrador usando o MultiPartyAuthReviewService.ResolveMultiPartyAuthReview método. Consulte o guia de aprovação de várias partes para saber mais.