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 funções de usuário, 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 à conta.

Para gerenciar o acesso do usuário, o usuário ou a conta de serviço 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 de 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

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 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 informar:

• O nome do recurso da entidade CustomerUserAccess a ser modificada, no formato customers/{customer_id}/customerUserAccesses/{user_id}.
• A nova função do usuário em access_role.
• Um update_mask (FieldMask) que especifica 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 outra parte 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 revisão pendente que precisa de aprovação.
• O campo resource_name em MutateCustomerUserAccessResult 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.