Próximas mudanças nas respostas de Search e SearchStream na API Google Ads

Terça-feira, 1º de julho de 2025

O que muda?

No ano passado, lançamos a métrica query_resource_consumption como uma forma de medir o custo de uma consulta da API Google Ads. No entanto, esse custo não era retornado quando os resultados da consulta estavam vazios.

A partir da semana de 4 de agosto de 2025, vamos modificar o comportamento dos métodos Search e SearchStream de GoogleAdsService em todas as versões da API para retornar a métrica query_resource_consumption e o campo field_mask, mesmo quando os resultados da consulta estiverem vazios. As respostas para resultados de consulta vazios vão mudar da seguinte maneira:

Método Resposta antiga Nova resposta
Pesquisar
{
    "fieldMask": "..."
}
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream
[]
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

O que preciso fazer?

Se você usa os métodos Search e SearchStream para baixar relatórios da API Google Ads, verifique se o aplicativo pode processar a resposta modificada.

Se tiver dúvidas ou precisar de ajuda, consulte a página de suporte da API Google Ads para ver as opções.

Entre em contato com a equipe de suporte ao produto do Google Ads se tiver dúvidas sobre as políticas da conta.

Marcadores: google-ads-api, reporting