SearchGoogleAdsRequest

  • The request message for GoogleAdsService.Search requires a customer ID and a query string.

  • Optional fields include page_token, validate_only, and search_settings.

  • The page_size field is deprecated and will cause an error if set in v17 and later.

Request message for GoogleAdsService.Search.

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.