keyword_plan

  • Keyword Planner plans have a maximum limit of 10,000 saved plans per customer, and old plans can be removed to stay within this limit.

  • Fields from the customer resource can be selected along with the keyword_plan resource but will not segment metrics in the SELECT clause.

  • The keyword_plan.id, keyword_plan.name, and keyword_plan.resource_name fields are all selectable and filterable.

  • The keyword_plan.forecast_period field describes the date range used for forecasting 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.v19.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