Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on January 29th at 10:00 AM EST! We will discuss the new features added in v23 of the Google Ads API.
GenerateKeywordHistoricalMetricsRequest
Stay organized with collections
Save and categorize content based on your preferences.
| Fields |
aggregate_metrics
|
KeywordPlanAggregateMetrics
The aggregate fields to include in response.
|
customer_id
|
string
The ID of the customer with the recommendation.
|
geo_target_constants[]
|
string
The resource names of the location to target. Maximum is 10. An empty list MAY be used to specify all targeting geos.
|
historical_metrics_options
|
HistoricalMetricsOptions
The options for historical metrics data.
|
include_adult_keywords
|
bool
If true, adult keywords will be included in response. The default value is false.
|
keyword_plan_network
|
KeywordPlanNetwork
Targeting network. If not set, Google Search And Partners Network will be used.
|
keywords[]
|
string
A list of keywords to get historical metrics. Not all inputs will be returned as a result of near-exact deduplication. For example, if stats for "car" and "cars" are requested, only "car" will be returned. A maximum of 10,000 keywords can be used.
|
language
|
string
The resource name of the language to target. Each keyword belongs to some set of languages; a keyword is included if language is one of its languages. If not set, all keywords will be included.
|
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 2026-01-22 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 2026-01-22 UTC."],[],[]]
