keyword_plan

  • Keyword plans represent a Keyword Planner plan with a maximum of 10000 allowed saved plans.

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

  • The keyword_plan resource includes fields such as forecast_period, id, name, and resource_name.

  • The forecast_period field indicates the date period used for forecasting and is not filterable or sortable.

  • The id, name, and resource_name fields provide identifying information about the keyword plan and are filterable and selectable, with id and name also being 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.v22.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