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.

REST Resource: customers.keywordPlanAdGroups

Resource: KeywordPlanAdGroup

A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200.

JSON representation
{
  "resourceName": string,
  "keywordPlanCampaign": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string
}
Fields
resourceName

string

Immutable. The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form:

customers/{customerId}/keywordPlanAdGroups/{kp_ad_group_id}

keywordPlanCampaign

string

The keyword plan campaign to which this ad group belongs.

id

string (int64 format)

Output only. The ID of the keyword plan ad group.

name

string

The name of the keyword plan ad group.

This field is required and should not be empty when creating keyword plan ad group.

cpcBidMicros

string (int64 format)

A default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.

Methods

get

Returns the requested Keyword Plan ad group in full detail.

mutate

Creates, updates, or removes Keyword Plan ad groups.