Предстоящие изменения в ответах Search и SearchStream в Google Ads API

Вторник, 1 июля 2025 г.

Что изменится

В прошлом году мы добавили показатель query_resource_consumption, позволяющий оценить стоимость запроса к Google Ads API. Однако эта стоимость не возвращалась, если результаты запроса были пустыми.

Начиная с 4 августа 2025 г. мы изменим поведение методов Search и SearchStream в GoogleAdsService во всех версиях API, чтобы они возвращали показатель query_resource_consumption и поле field_mask, даже если результаты запроса пусты. Ответы для пустых результатов запроса изменятся следующим образом:

Метод Старый ответ Новый ответ
Поиск 
{
    "fieldMask": "..."
}
 
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream 
[]
 
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

Что нужно сделать?

Если вы используете методы Search и SearchStream для скачивания отчетов Google Ads API, убедитесь, что ваше приложение может обрабатывать измененный ответ.

Если у вас есть вопросы или вам нужна помощь, посетите страницу поддержки Google Ads API.

Если у вас есть вопросы о правилах в отношении аккаунтов, обратитесь в службу поддержки Google Рекламы.

Портрет автора – , Google Ads API Team

Ярлыки: google-ads-api, reporting