keyword_plan

  • Keyword plans have a maximum limit of 10000 saved plans, and older plans can be removed if the limit is reached.

  • Fields from attributed resources like customer can be selected in queries but will not segment metrics.

  • The keyword_plan.forecast_period field indicates the date range used for forecasting and is selectable but not filterable or sortable.

  • The keyword_plan.id field is an output-only identifier for the plan that is filterable, selectable, and sortable.

  • The keyword_plan.name field is a required string for naming the plan and is filterable, selectable, and sortable.

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

Attributed resources
customer

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 descriptionThe date period used for forecasting the plan.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v20.resources.KeywordPlanForecastPeriod
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

keyword_plan.id

Field descriptionOutput only. The ID of the keyword plan.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan.name

Field descriptionThe name of the keyword plan. This field is required and should not be empty when creating new keyword plans.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse