KeywordPlanAdGroupKeyword

  • Keyword Plan ad group keywords are a component of a Keyword Plan, with a limit of 10,000 keywords per plan.

  • Each Keyword Plan ad group keyword has properties such as resource name, match type, the associated Keyword Plan ad group, ID, text, optional CPC bid in micros, and a flag indicating if it is negative.

  • The resource name follows a specific format including the customer ID and the keyword plan ad group keyword ID.

  • The CPC bid in micros allows for setting a maximum CPC at the keyword level, overriding any bid set at the ad group level, and is not applicable to negative keywords.

  • Thenegative field is an immutable boolean indicating whether the keyword is a negative keyword.

A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000.

Proto definition

Fields

cpc_bid_micros

int64

A keyword level max cpc bid in micros (for example, $1 = 1mm). The currency is the same as the account currency code. This will override any CPC bid set at the keyword plan ad group level. Not applicable for negative keywords. (negative = true) This field is Optional.

id

int64

Output only. The ID of the Keyword Plan keyword.

keyword_plan_ad_group

string

The Keyword Plan ad group to which this keyword belongs.

match_type

KeywordMatchType

The keyword match type.

negative

bool

Immutable. If true, the keyword is negative.

resource_name

string

Immutable. The resource name of the Keyword Plan ad group keyword. KeywordPlanAdGroupKeyword resource names have the form:

customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}

text

string

The keyword text.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-12 UTC.