Tuesday, July 1, 2025


**What's changing?**


Last year, we [introduced](https://developers.google.com/ads/blog/posts/2024/05/google-ads-api-resource-usage-policy.md.txt) `query_resource_consumption` metric as a way to measure how expensive a Google Ads API query is. However, this cost was not returned when the query results were empty.


Starting the week of **August 4, 2025** , we will modify the behavior of both the `Search` and `SearchStream` methods of `GoogleAdsService` in all the API versions to return the `query_resource_consumption` metric and the `field_mask` field even when the query results are empty. The responses for empty query results will change as follows:

<br />

| Method | Old response | New response |
|---|---|---|
| Search | ```java { "fieldMask": "..." } ``` | ```java { "fieldMask": "...", "query_resource_consumption": 123 } ``` |
| SearchStream | ```java [] ``` | ```java { "fieldMask": "...", "queryResourceConsumption": 206 } ``` |


**What do I need to do?**


If you are using `Search` and `SearchStream` methods to download Google Ads API reports, make sure your application can handle the modified response.


If you have any questions or need help, check out the Google Ads API [support page](https://developers.google.com/google-ads/api/support.md.txt) for options.


Reach out to the [Google Ads product support team](https://support.google.com/google-ads/gethelp) for any questions related to account policies.

[![Portrait of the author](https://developers.google.com/static/ads/blog/images/AD_cMMRmfdsXvZhyLvWsLuqqcScxtYI0ih7DPGCk8lTee140NzXH=s300.jpg)](https://g.dev/anash) - [Anash P. Oommen](https://g.dev/anash), Google Ads API Team

**Labels:**

[google-ads-api](https://developers.google.com/ads/blog/feeds/labels/google-ads-api.md.txt),

[reporting](https://developers.google.com/ads/blog/feeds/labels/reporting.md.txt)