> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateKeywordHistoricalMetricsRequest).

Request message for `KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics`.

[Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/services/keyword_plan_idea_service.proto)

| 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. |