KeywordPlanAdGroupKeyword

  • Each Keyword Plan can have a maximum of 10,000 keywords.

  • The resource name for a Keyword Plan ad group keyword follows a specific format including customer and keyword ID.

  • Key attributes of a Keyword Plan ad group keyword include its match type, the associated ad group, an output-only ID, the keyword text, an optional CPC bid, and whether it is negative.

  • CPC bids in micros can be set at the keyword level, overriding bids at the ad group level, and are not applicable for negative keywords.

  • A keyword's negative status, once set to true, is immutable.

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.