To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

SearchGoogleAdsRequest

AI-generated Key Takeaways

The request message for GoogleAdsService.Search requires a customer ID and a query string.
Optional fields include page_token for pagination and validate_only to validate the request without execution.
The page_size field is deprecated and will result in an error if used.
Additional settings can be specified using the search_settings field which refers to SearchSettings.

Fields
`customer_id`	`string` Required. The ID of the customer being queried.
`query`	`string` Required. The query string.
`page_token`	`string` Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from `next_page_token` in the previous response in order to request the next page of results.
`page_size`	`int32` This field is deprecated and will be removed in a future version of the API. As of v17, Google Ads API will return a `PAGE_SIZE_NOT_SUPPORTED` error if this field is set in the request body. See https://ads-developers.googleblog.com/2024/07/upcoming-changes-to-page-size-in-google.html to learn more details.
`validate_only`	`bool` If true, the request is validated but not executed.
`search_settings`	`SearchSettings` Settings that allow users to specify request count, summary row, and results behavior.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-07 UTC.