Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
keyword_plan
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
A Keyword Planner plan.
Max number of saved keyword plans: 10000.
It's possible to remove plans if limit is reached.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT clause.
keyword_plan.forecast_period
Field description The date period used for forecasting the plan.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.resources.KeywordPlanForecastPeriod
Filterable False
Selectable True
Sortable False
Repeated False
Selectable with
The following fields/resources can be selected with this field:
keyword_plan.id
Field description Output only. The ID of the keyword plan.
Category ATTRIBUTE
Data Type INT64
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
keyword_plan.name
Field description The name of the keyword plan.
This field is required and should not be empty when creating new keyword
plans.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
keyword_plan.resource_name
Field description Immutable. 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
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False
Selectable with
The following fields/resources can be selected with this field:
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-10-14 UTC.
[null,null,["Last updated 2026-10-14 UTC."],[],[]]