Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.


Stay organized with collections Save and categorize content based on your preferences.

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

JSON representation
  "resourceName": string,
  "forecastPeriod": {
    object (KeywordPlanForecastPeriod)
  "id": string,
  "name": string


Immutable. The resource name of the Keyword Planner plan. KeywordPlan resource names have the form:



object (KeywordPlanForecastPeriod)

The date period used for forecasting the plan.


string (int64 format)

Output only. The ID of the keyword plan.



The name of the keyword plan.

This field is required and should not be empty when creating new keyword plans.


The forecasting period associated with the keyword plan.

JSON representation

  // Union field interval can be only one of the following:
  "dateInterval": enum (KeywordPlanForecastInterval),
  "dateRange": {
    object (DateRange)
  // End of list of possible types for union field interval.
Union field interval. Required. The date used for forecasting the Plan. interval can be only one of the following:

enum (KeywordPlanForecastInterval)

A future date range relative to the current date used for forecasting.


object (DateRange)

The custom date range used for forecasting. It cannot be greater than a year. The start and end dates must be in the future. Otherwise, an error will be returned when the forecasting action is performed. The start and end dates are inclusive.


Forecast intervals.

UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
NEXT_WEEK The next week date range for keyword plan. The next week is based on the default locale of the user's account and is mostly SUN-SAT or MON-SUN. This can be different from next-7 days.
NEXT_MONTH The next month date range for keyword plan.
NEXT_QUARTER The next quarter date range for keyword plan.