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

[Help me build a query](https://developers.google.com/google-ads/api/fields/v23/keyword_plan_query_builder.md.txt) [Proto definition ![on GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/resources/keyword_plan.proto)

A Keyword Planner plan.
Max number of saved keyword plans: 10000.
It's possible to remove plans if limit is reached.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v23/customer.md.txt) |

Fields from the preceding resources can be selected along with this
resource in your `SELECT` and `WHERE` clauses. These fields do **not** segment
metrics in your `SELECT` clause.

## keyword_plan.forecast_period

Field descriptionThe date period used for forecasting the plan.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v23.resources.KeywordPlanForecastPeriod` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [keyword_plan](https://developers.google.com/google-ads/api/fields/v23/keyword_plan.md.txt), [keyword_plan_ad_group](https://developers.google.com/google-ads/api/fields/v23/keyword_plan_ad_group.md.txt), [keyword_plan_ad_group_keyword](https://developers.google.com/google-ads/api/fields/v23/keyword_plan_ad_group_keyword.md.txt), [keyword_plan_campaign](https://developers.google.com/google-ads/api/fields/v23/keyword_plan_campaign.md.txt), [keyword_plan_campaign_keyword](https://developers.google.com/google-ads/api/fields/v23/keyword_plan_campaign_keyword.md.txt)

## keyword_plan.id

Field descriptionOutput only. The ID of the keyword plan.
Category`ATTRIBUTE` Data Type`INT64` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [keyword_plan.forecast_period](https://developers.google.com/google-ads/api/fields/v23/keyword_plan.md.txt#keyword_plan.forecast_period).

## keyword_plan.name

Field descriptionThe name of the keyword plan.

This field is required and should not be empty when creating new keyword
plans.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [keyword_plan.forecast_period](https://developers.google.com/google-ads/api/fields/v23/keyword_plan.md.txt#keyword_plan.forecast_period).

## keyword_plan.resource_name

Field descriptionImmutable. The resource name of the Keyword Planner plan.
KeywordPlan resource names have the form:

`customers/{customer_id}/keywordPlans/{kp_plan_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [keyword_plan.forecast_period](https://developers.google.com/google-ads/api/fields/v23/keyword_plan.md.txt#keyword_plan.forecast_period).