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 funções de usuário, além de encerrar o acesso de um usuário a uma conta. Saiba mais sobre os níveis de acesso à conta.

Recuperar funções do usuário

Para conferir 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ário

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

Se o Google determinar que um MPA é necessário:

• O MutateCustomerUserAccessResponse vai preencher o campo multi_party_auth_review com o nome do recurso da avaliação pendente que precisa de aprovação.
• O campo resource_name não será preenchido.
• O pedido de revisão pendente pode ser aprovado ou rejeitado por um segundo administrador usando o método MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Consulte o guia de aprovação de outra parte para saber mais.

Remover usuários

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

Assim como a atualização das funções de usuário, a remoção de um usuário é uma ação sensível que pode acionar uma MPA a partir de 30 de julho de 2026. Se uma MPA for acionada:

• O MutateCustomerUserAccessResponse vai preencher o campo multi_party_auth_review com o nome do recurso da avaliação pendente que precisa de aprovação.
• O campo resource_name não será preenchido.
• O pedido de revisão pendente pode ser aprovado ou rejeitado por um segundo administrador usando o método MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Consulte o guia de aprovação de outra parte para saber mais.