keyword_plan

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

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