AdGroupUpdate

The request body for updating an existing ad group.

Declaration

object AdGroupUpdate

Properties

Name	Type	Description
`name`	string	The advertiser-given name of this ad group. Mutable.
`startTime`	date-time	The scheduled start date and time of this ad group in ISO 8601 format. Mutable.
`endTime`	date-time	The scheduled end date and time. Omit to inherit the campaign end date. Mutable.
`automatedKeywordsOptIn`	boolean	Opt in to Search Match, which automatically matches search terms without requiring explicit keywords. Mutable.
`status`	`AdGroupUpdate.Status`	Advertiser-configurable serving status. Use to pause (`PAUSED`) or resume (`ENABLED`) this ad group. See AdGroupStatus. Mutable.
`automatedKeywordsRequired`	boolean	Immutable. Set at creation via `AdGroupCreate`. Any value sent here is ignored.
`bidStrategy`	`AdGroupUpdate.BidStrategy`	The bid strategy for this ad group. `bidStrategyType` and `bidStrategyGoal` must be sent together and matched per the pairings in BidStrategy. See AdGroupUpdate.BidStrategy and BidStrategyUpdate. Mutable.
`targeting`	`AdGroupUpdate.Targeting`	Audience and placement targeting configuration for this ad group. See AdGroupTargetingUpdate. Mutable.
`cpaCap`	`AdGroupUpdate.CpaCap`	Deprecated. Still accepted on update for backward compatibility, but use `bidStrategy` with `MAX_CONVERSIONS` instead. See CPAGoalUpdate.

Discussion

The AdGroupUpdate object is the request payload for modifying an existing ad group. Include only the fields you want to change. The pricingModel and automatedKeywordsRequired fields are immutable.

To manage keywords and negative keywords, use the dedicated keyword endpoints.

Example

{
  "name": "AwayFinder iOS — New Users 18-34",
  "startTime": "2025-09-01T00:00:00.000",
  "endTime": "2025-12-31T23:59:59.000",
  "automatedKeywordsOptIn": false,
  "status": "ENABLED",
  "bidStrategy": {
    "bidStrategyType": "MANUAL_CPT",
    "bidStrategyGoal": "TAP",
    "bid": {
      "amount": "7.50",
      "currency": "USD"
    }
  },
  "targeting": {
    "deviceClass": {
      "include": [
        "IPHONE"
      ]
    },
    "minAge": {
      "include": [
        "18"
      ]
    },
    "maxAge": {
      "include": [
        "34"
      ]
    }
  }
}

Topics

Dictionaries

Type Aliases

AdGroupUpdate.Status