keyword_plan
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[],[],null,["# keyword_plan\n\n[Help me build a query](/google-ads/api/fields/v20/keyword_plan_query_builder)\n\nA Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached.\n\n| Attributed resources |\n|-------------------------------------------------|\n| [customer](/google-ads/api/fields/v20/customer) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | keyword_plan.forecast_period ---------------------------- || |-------------------|----------------------------------------------------------------| | Field description | The date period used for forecasting the plan. | | Category | `ATTRIBUTE` | | Data Type | `MESSAGE` | | Type URL | `google.ads.googleads.v20.resources.KeywordPlanForecastPeriod` | | Filterable | False | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | keyword_plan.id --------------- || |-------------------|------------------------------------------| | Field description | Output only. The ID of the keyword plan. | | Category | `ATTRIBUTE` | | Data Type | `INT64` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | keyword_plan.name ----------------- || |-------------------|---------------------------------------------------------------------------------------------------------------| | Field description | The name of the keyword plan. This field is required and should not be empty when creating new keyword plans. | | Category | `ATTRIBUTE` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | keyword_plan.resource_name -------------------------- || |-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| | Field description | Immutable. The resource name of the Keyword Planner plan. KeywordPlan resource names have the form: `customers/{customer_id}/keywordPlans/{kp_plan_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |"]]