Aprovações de outra parte na API Google Ads

Quinta-feira, 25 de junho de 2026

Para reforçar a segurança das contas do Google Ads, a API Google Ads vai começar a exigir aprovações de outra parte antes de executar ações sensíveis. Isso faz parte de uma mudança mais ampla no Google Ads que exige aprovações de outra parte para realizar ações sensíveis na sua conta do Google Ads. Essas importantes atualizações de segurança serão lançadas a partir de 27 de julho de 2026 e ativadas para todos os usuários nas próximas semanas.

O que muda?

Quando essa mudança entrar em vigor, as seguintes chamadas de API vão mudar de comportamento.

Convidar um usuário

Se você usar o método CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation para convidar um novo usuário para gerenciar uma conta do Google Ads, a API Google Ads agora vai avaliar se a aprovação de várias partes é necessária. Nos casos em que nossos servidores determinarem que uma revisão é necessária, o sistema vai pausar o fluxo de trabalho padrão e não vai gerar um CustomerUserAccessInvitation nem enviar o e-mail de convite imediatamente. Em vez disso, um recurso MultiPartyAuthReview é iniciado, com o nome do recurso fornecido na resposta. Depois que a análise pendente for aprovada por um segundo administrador da conta, o CustomerUserAccessInvitation será criado, e o usuário convidado vai receber o e-mail. Não é possível criar novos convites para o usuário até que a análise pendente seja resolvida.

Atualizar ou encerrar o acesso de um usuário

Se você usar o método CustomerUserAccessService.MutateCustomerUserAccess para ajustar as permissões de um usuário com a operação de atualização ou revogar o acesso com a operação de remoção, a API Google Ads vai avaliar se a aprovação de várias partes é necessária. Nos casos em que nossos servidores determinam que uma revisão é necessária, a API gera um recurso MultiPartyAuthReview em um estado pendente e retorna o nome do recurso. As mudanças solicitadas vão permanecer pendentes e só vão entrar em vigor quando a análise de outra parte for aprovada por um segundo admin da conta. O CustomerUserAccess em revisão não pode ser alterado até que a revisão pendente seja resolvida.

Como aprovar um pedido de aprovação de outra parte?

É possível buscar um MultiPartyAuthReview pendente usando os métodos GoogleAdsService.Search ou GoogleAdsService.SearchStream com a seguinte consulta GAQL. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Uma solicitação de MultiPartyAuthReview pendente pode ser aprovada ou rejeitada usando uma solicitação de API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. A análise precisa ser feita por um segundo administrador que não tenha criado a solicitação original. Pode ser uma pessoa ou uma conta de serviço com privilégios de administrador. A revisão pendente pode ser revogada pelo solicitante original.

O que preciso fazer?

Caso seu aplicativo use esses métodos, atualize-o para que processe os fluxos de trabalho com aprovação de outra parte antes de 27 de julho de 2026. Adicionamos compatibilidade com as aprovações de outra parte em todas as versões principais da API (v24.2, v23.3, v22.2 e v21.2). Se você estiver usando uma biblioteca de cliente oficial, baixe a versão mais recente. Consulte os guias a seguir para saber mais sobre essas mudanças, inclusive detalhes sobre:

Se tiver dúvidas ou quiser discutir essa atualização, entre em contato com a gente no servidor do Discord "Google Advertising and Measurement Community". Para suporte técnico, entre em contato pelo link https://support.google.com/google-ads/contact/google_ads_api.

Retrato do autor - , equipe da API Google Ads

Marcadores: authorization, google-ads-api