Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
SearchGoogleAdsRequest
Stay organized with collections
Save and categorize content based on your preferences.
| 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
Number of elements to retrieve in a single page. When too large a page is requested, the server may decide to further limit the number of returned resources.
|
validate_only
|
bool
If true, the request is validated but not executed.
|
return_total_results_count
|
bool
If true, the total number of results that match the query ignoring the LIMIT clause will be included in the response. Default is false.
|
summary_row_setting
|
SummaryRowSetting
Determines whether a summary row will be returned. By default, summary row is not returned. If requested, the summary row will be sent in a response by itself after all other query results are returned.
|
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-01-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-10 UTC."],[[["Executes a search query to retrieve Google Ads data for a specific customer ID."],["Requires a search query string and customer ID."],["Supports pagination to retrieve large result sets, using `page_token` and `page_size`."],["Offers options for validation without execution (`validate_only`) and retrieving total result counts (`return_total_results_count`)."],["Allows customization of summary row inclusion using `summary_row_setting`."]]],[]]
