Quarta-feira, 4 de novembro de 2026
No início deste ano, a API Google Ads começou a exigir aprovações de outra parte (MPA, na sigla em inglês) antes de executar ações sensíveis. A partir da semana de 7 de dezembro de 2026, vamos implementar outras mudanças para melhorar a experiência do desenvolvedor com as aprovações de várias partes.
O que muda?
Criação de convite de acesso adiada: se uma aprovação de outra parte for necessária, o método CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation vai adiar a criação do recurso de convite de acesso até que o pedido de aprovação de outra parte seja aprovado. O campo resource_name não é preenchido nesses casos. Depois que o pedido de MPA pendente for aprovado, o recurso de convite de acesso vai ficar disponível nos resultados da análise. No momento, esse método cria o convite e retorna o resource_name dele, mas não realiza outras ações, como enviar um e-mail de convite, até que o pedido de MPA associado seja aprovado.
Novo código de erro para pedidos desatualizados: vamos começar a retornar um novo código de erro MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST no campo de falha parcial quando um pedido de MPA pendente não for mais válido porque o recurso de destino foi modificado ou excluído após a criação da análise. Esse código do erro será introduzido na próxima versão v26.2. As versões mais antigas da API (v23 a v25) vão retornar um erro MultiPartyAuthReviewError.UNKNOWN, e o campo unpublished_error_code em GoogleAdsError.details será definido como MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.
Limites maiores para avaliações de MPA: é possível resolver até 100 avaliações de MPA pendentes em uma única chamada para o método MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. No momento, esse método é limitado a uma avaliação por chamada de API.
Ação necessária
Se você usa aprovações de várias partes, revise e atualize seu código para refletir o novo comportamento da API antes de 7 de dezembro de 2026. Se você estiver usando a v26 da API Google Ads, baixe as bibliotecas de cliente mais recentes após o lançamento da v26.2 para receber suporte ao novo código de erro STALE_MULTI_PARTY_AUTH_REQUEST. Consulte nossos guias técnicos para saber mais sobre as aprovações de outra parte. Para suporte técnico, entre em contato com o suporte da API Google Ads. Se tiver dúvidas ou quiser discutir este post, entre em contato com a gente no servidor do Discord da Comunidade de Publicidade e Medição do Google.
- Anash P. , equipe da API Google Ads
Marcadores: autorização, google-ads-api, lançamento