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.
This field is required and should not be empty when creating new keyword plans.
KeywordPlanForecastPeriod
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.}
Fields
Union field interval. Required. The date used for forecasting the Plan. interval can be only one of the following:
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.
KeywordPlanForecastInterval
Forecast intervals.
Enums
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[[["A Keyword Planner plan allows for forecasting and management of up to 10,000 keyword plans, with the ability to remove plans if the limit is reached."],["Each plan uses a forecast period, which can be a predefined interval (e.g., next week, month, quarter) or a custom date range up to a year in the future."],["Keyword plans are identified by a resource name in the format `customers/{customerId}/keywordPlans/{kp_plan_id}` and can be given a descriptive name."],["The forecast period's start and end dates must be in the future to avoid errors during forecasting actions."]]],["Keyword plans, with a limit of 10,000, include a `resourceName`, `forecastPeriod`, `id`, and `name`. The `forecastPeriod` uses either a `dateInterval` (e.g., `NEXT_WEEK`, `NEXT_MONTH`, `NEXT_QUARTER`) or a custom `dateRange` for forecasting, which must be within a year and in the future. `dateRange` start and end dates are inclusive. New plans require a non-empty name. Plans can be removed if the limit is reached.\n"]]