Upcoming changes to Search and SearchStream responses in Google Ads API

[Xuan Van Do]

Hello Google Support Team,

As per the announcement in this post, I'd like to confirm the new response format when I use the SearchStream method:

1. When the query results are empty, will the new response be A or B or C?
   A: 
   [{ "results": [], "fieldMask": "...", "queryResourceConsumption": 206 }]
   B: 
   [{"fieldMask": "...", "queryResourceConsumption": 206 }]
   C: 
   {"fieldMask": "...", "queryResourceConsumption": 206 }

2. When the query results are non-empty, will the new response still be an array of data?

Thank you for your assistance!

Best regards, 
Do Xuan Van

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

As per the blog post and API guide, please find the below answers to your concern for the searchstream response.

1.When the query results are empty, will the new response be A or B or C?

If the query results are empty then the response is ‘C’.

{

    "fieldMask": "...",

    "query_resource_consumption": …

}

2.When the query results are non-empty, will the new response still be an array of data?

{

  "results": [ …. ],

  "fieldMask":  “....”,

  “Request_id” :”....”,

  "queryResourceConsumption" : ...

}

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-07-17 10:17:33Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01svwZJ:ref" (ADR-00319169)

[Xuan Van Do]

Thank for your response!
According to the announcement, there are no changes when the query results are non-empty. However, based on your answer, it also changes, and the query results are not an array as shown in the image. Could you please confirm this for me? Thank you!

[Google Ads API Forum Advisor]

Hi,

I would like to inform you that if the search query returns results, the API will continue to function as it has previously. There's no specific announcement regarding the API's behavior when non-empty results are encountered.​ ​Also, kindly note that when the impressions, clicks, and conversions are zero, that data won't be returned by the API that could be the reason you are not getting the array of data while fetching the details via the API. For more information, refer to the zero metrics.

If you still need any further assistance, I request you please share the uncropped UI screenshot by highlighting the data that you would like to retrieve via the Google Ads API.

You can send the details via Reply privately to the author option, or direct private reply to this email.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-07-18 05:28:32Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01svwZJ:ref" (ADR-00319169)