Send feedback
keyword_plan
Stay organized with collections
Save and categorize content based on your preferences.
outlined_flag
Keyword Planner plans have a maximum limit of 10000, and plans can be removed if the limit is reached.
The resource customer
can be selected along with this resource in SELECT and WHERE clauses, but will not segment metrics in the SELECT clause.
The keyword_plan.forecast_period
field indicates the date period used for forecasting the plan.
The keyword_plan.id
field is an output-only field representing the ID of the keyword plan.
The keyword_plan.name
field is required for creating new keyword plans and represents the name of the plan.
Help me build a query
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.v21.resources.KeywordPlanForecastPeriod
Filterable False
Selectable True
Sortable False
Repeated False
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
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
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
Send feedback
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-10-16 UTC.
Need to tell us more?
[[["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-10-16 UTC."],[],[]]