# REST Resource: advertisers.adGroups

> [!WARNING]
> Display \& Video 360 API v3 has sunset. Use [v4](https://developers.google.com/display-video/api/reference/rest/v4) instead.

- [Resource: AdGroup](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroup)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroup.SCHEMA_REPRESENTATION)
- [AdGroupFormat](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat)
- [ProductFeedData](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductFeedData)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductFeedData.SCHEMA_REPRESENTATION)
- [ProductMatchType](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchType)
- [ProductMatchDimension](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchDimension)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchDimension.SCHEMA_REPRESENTATION)
- [CustomLabel](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabel)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabel.SCHEMA_REPRESENTATION)
- [CustomLabelKey](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabelKey)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#METHODS_SUMMARY)

## Resource: AdGroup

A single ad group associated with a line item.

| JSON representation |
|---|
| ``` { "name": string, "advertiserId": string, "adGroupId": string, "lineItemId": string, "displayName": string, "adGroupFormat": enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat`), "bidStrategy": { object (`https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy`) }, "entityStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v3/EntityStatus`), "targetingExpansion": { object (`https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig`) }, "productFeedData": { object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductFeedData`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the ad group. |
| `advertiserId` | `string (https://developers.google.com/discovery/v1/type-format format)` The unique ID of the advertiser the ad group belongs to. |
| `adGroupId` | `string (https://developers.google.com/discovery/v1/type-format format)` The unique ID of the ad group. Assigned by the system. |
| `lineItemId` | `string (https://developers.google.com/discovery/v1/type-format format)` The unique ID of the line item that the ad group belongs to. |
| `displayName` | `string` The display name of the ad group. Must be UTF-8 encoded with a maximum size of 255 bytes. |
| `adGroupFormat` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat`)`` The format of the ads in the ad group. |
| `bidStrategy` | ``object (`https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy`)`` The bidding strategy used by the ad group. Only the `https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy#FIELDS.youtube_and_partners_bid` field can be used in the bidding strategy. |
| `entityStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v3/EntityStatus`)`` Controls whether or not the ad group can spend its budget and bid on inventory. If the ad group's parent line item is not active, the ad group can't spend its budget even if its own status is `ENTITY_STATUS_ACTIVE`. |
| `targetingExpansion` | ``object (`https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig`)`` The [optimized targeting](https://support.google.com/displayvideo/answer/12060859) settings of the ad group. |
| `productFeedData` | ``object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductFeedData`)`` The settings of the product feed in this ad group. |

## AdGroupFormat

The format of the ad group.

| Enums ||
|---|---|
| `AD_GROUP_FORMAT_UNSPECIFIED` | Format value is not specified or is unknown in this version. |
| `AD_GROUP_FORMAT_IN_STREAM` | In-stream ads. |
| `AD_GROUP_FORMAT_VIDEO_DISCOVERY` | In-feed ads. |
| `AD_GROUP_FORMAT_BUMPER` | Bumper ads. |
| `AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM` | Non-skippable in-stream ads. |
| `AD_GROUP_FORMAT_AUDIO` | Non-skippable in-stream audio ads. |
| `AD_GROUP_FORMAT_RESPONSIVE` | Responsive ads. |
| `AD_GROUP_FORMAT_REACH` | [Effective reach ad groups](https://support.google.com/displayvideo/answer/9173684), including in-stream and bumper ads. |
| `AD_GROUP_FORMAT_MASTHEAD` | Masthead Ad that is surfaced on the top slot on the YouTube homepage. |

## ProductFeedData

The details of product feed.

| JSON representation |
|---|
| ``` { "productMatchType": enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchType`), "productMatchDimensions": [ { object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchDimension`) } ], "isFeedDisabled": boolean } ``` |

| Fields ||
|---|---|
| `productMatchType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchType`)`` How products are selected by the product feed. |
| `productMatchDimensions[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#ProductMatchDimension`)`` A list of dimensions used to match products. |
| `isFeedDisabled` | `boolean` Whether the product feed has opted-out of showing products. |

## ProductMatchType

The types of the ways to match products.

| Enums ||
|---|---|
| `PRODUCT_MATCH_TYPE_UNSPECIFIED` | Not specified or unknown. |
| `PRODUCT_MATCH_TYPE_ALL_PRODUCTS` | All the products are matched. |
| `PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS` | Specific products are selected. |
| `PRODUCT_MATCH_TYPE_CUSTOM_LABEL` | Match products by their custom labels. |

## ProductMatchDimension

A dimension used to match products.

| JSON representation |
|---|
| ``` { // Union field `dimension` can be only one of the following: "productOfferId": string, "customLabel": { object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabel`) } // End of list of possible types for union field `dimension`. } ``` |

| Fields ||
|---|---|
| Union field `dimension`. The dimension and value on which to match the product. `dimension` can be only one of the following: ||
| `productOfferId` | `string` The ID of the product offer to match with a product with the same offer ID. |
| `customLabel` | ``object (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabel`)`` The custom label to match all the products with the label. |

## CustomLabel

The key and value of a custom label.

| JSON representation |
|---|
| ``` { "key": enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabelKey`), "value": string } ``` |

| Fields ||
|---|---|
| `key` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#CustomLabelKey`)`` The key of the label. |
| `value` | `string` The value of the label. |

## CustomLabelKey

The key of the custom label

| Enums ||
|---|---|
| `CUSTOM_LABEL_KEY_UNSPECIFIED` | Not specified or unknown. |
| `CUSTOM_LABEL_KEY_0` | Key index 0. |
| `CUSTOM_LABEL_KEY_1` | Key index 1. |
| `CUSTOM_LABEL_KEY_2` | Key index 2. |
| `CUSTOM_LABEL_KEY_3` | Key index 3. |
| `CUSTOM_LABEL_KEY_4` | Key index 4. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/bulkListAdGroupAssignedTargetingOptions` | Lists assigned targeting options for multiple ad groups across targeting types. |
| ### `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/get` | Gets an ad group. |
| ### `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/list` | Lists ad groups. |