---
title: AdGroupUpdate
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 2.0+]
path: apple_ads/adgroupupdate
---

# AdGroupUpdate

The list of ad group fields that are updatable.

## Declaration

```data
object AdGroupUpdate
```

## Properties

automatedKeywordsOptIn: The parameter for enabling and disabling Search Match. If true, the system automatically adds optimized keywords in addition to those you explicitly add to the ad group. See the Enable and Disable Search Match section of Ad Groups. cpaGoal: The cost-per-acquisition goal. Cannot be set for ad groups in MAX_CONVERSIONS campaigns. Returned as null for Max Conversions ad groups. important: You can update the cpaGoal only in campaigns that use the APPSTORE_SEARCH_RESULTS supply source. This field is updatable. defaultBidAmount: The default maximum cost-per-tap or cost-per-impression bid for the ad group. This field is updatable. endTime: The scheduled end date and time for the ad group, which the system determines from the ad group with the latest end time. The endTime is updatable until you reach the designated time. The endTime must be after the startTime. The endTime must be in UTC. name: The unique name of the ad group. Responses don’t include deleted ad groups. This field is updatable. startTime: The scheduled start date and time for the ad group with the earliest start time in the campaign. The startTime must be greater than the current time, and before the campaign endTime, if you set it. If you don’t set a startTime, the campaign defaults to the campaign request timestamp and the startTime is updatable until you reach the designated time. The startTime must be in UTC. status: The user-controlled status to enable or pause the ad group. This field is updatable. targetingDimensions: The targeting criteria to narrow the audience. Targeting options include age, gender, geolocation, daypart, device, and app downloaders. This field is updatable.

## See Also

### Ad Group Request and Response Objects

- [AdGroup](apple_ads/adgroup.md)
- [AdGroupResponse](apple_ads/adgroupresponse.md)
- [AdGroupListResponse](apple_ads/adgrouplistresponse.md)