Last year, Google Ads API introduced the query_resource_consumption metric to measure the cost of API queries, but this metric was not returned when query results were empty. Starting the week of August 4, 2025, the behavior of the Search and SearchStream methods of GoogleAdsService will change across all API versions to include both the query_resource_consumption metric and the field_mask field even when query results are empty.
Changes in Response for Empty Query Results
| Method | Old Response | New Response |
|---|---|---|
| Search | { "fieldMask": "..." } |
{ "fieldMask": "...", "query_resource_consumption": 123 } |
| SearchStream | [] |
{ "fieldMask": "...", "queryResourceConsumption": 206 } |
Required Actions
Applications using Search and SearchStream methods to download Google Ads API reports must be updated to handle the modified response structure that now includes the query_resource_consumption metric even when results are empty.
For further assistance, the Google Ads API support page provides additional resources.
