Represents a Google Ads video ad group.

### Methods:

| Member | Type | Description |
|---|---|---|
| [applyLabel(name)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#applyLabel_name) | `void` | Applies a label to the video ad group. |
| [bidding()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#bidding) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroupbidding` | Provides access to this ad group's bidding fields. |
| [clearTopContentBidModifier()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#clearTopContentBidModifier) | `void` | > [!WARNING] > **Deprecated:** This method is deprecated and will be removed soon. |
| [devices()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#devices) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroupdevices` | Provides access to this ad group's device-specific configuration. |
| [enable()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#enable) | `void` | Enables the video ad group. |
| [getAdGroupType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getAdGroupType) | `String` | Returns the video ad group type. |
| [getEntityType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getEntityType) | `String` | Returns the type of this entity as a `String`, in this case, `"VideoAdGroup"`. |
| [getId()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getId) | `String` | Returns the ID of the video ad group. |
| [getName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getName) | `String` | Returns the name of the ad group. |
| [getResourceName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getResourceName) | `String` | Returns the resource name of the video ad group. |
| [getStatsFor(dateRange)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getStatsFor_dateRange) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified date range. |
| [getStatsFor(dateFrom, dateTo)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getStatsFor_dateFrom-dateTo) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified custom date range. |
| [getTopContentBidModifier()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getTopContentBidModifier) | `double` | > [!WARNING] > **Deprecated:** This method is deprecated and will be removed soon. |
| [getVideoCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#getVideoCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign` | Returns the campaign to which this video ad group belongs. |
| [isEnabled()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#isEnabled) | `boolean` | Returns `true` if the video ad group is enabled. |
| [isPaused()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#isPaused) | `boolean` | Returns `true` if the video ad group is paused. |
| [isRemoved()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#isRemoved) | `boolean` | Returns `true` if the ad group is removed. |
| [labels()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#labels) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_labelselector` | Creates a selector of all labels applied to the video ad group. |
| [newVideoAd()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#newVideoAd) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadbuilderspace` | Returns a new video ad builder space associated with this ad group. |
| [pause()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#pause) | `void` | Pauses the video ad group. |
| [removeLabel(name)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#removeLabel_name) | `void` | Removes a label from the video ad group. |
| [setName(name)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#setName_name) | `void` | Sets the name of the ad group. |
| [setTopContentBidModifier(modifier)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#setTopContentBidModifier_modifier) | `void` | > [!WARNING] > **Deprecated:** This method is deprecated and will be removed soon. |
| [videoAds()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#videoAds) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadselector` | Returns the selector of all ads in the video ad group. |
| [videoTargeting()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroup#videoTargeting) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroupvideotargeting` | Provides access to this ad group's video targeting criteria. |

## `applyLabel(name)`

Applies a label to the video ad group. `name` of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.

Note that the video ad group cannot have more than 50 labels.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| name | `String` | Name of the label to apply. |

## `bidding()`

Provides access to this ad group's bidding fields.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadgroupbidding` | Access to this ad group's bidding fields. |

## `clearTopContentBidModifier()`

> [!WARNING]
> **Deprecated:** This method is deprecated and will be removed soon.

Clears the top content bid modifier for this ad group. This is the equivalent as setting the bid modifier to `1.0`.

Returns nothing.

## `devices()`

Provides access to this ad group's device-specific configuration.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroupdevices` | An [AdGroupDevices](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroupdevices) instance associated with the ad group. |

## `enable()`

Enables the video ad group.

Returns nothing.

## `getAdGroupType()`

Returns the video ad group type. Possible return values:

`VIDEO_BUMPER, VIDEO_EFFICIENT_REACH,
VIDEO_NON_SKIPPABLE_IN_STREAM, VIDEO_RESPONSIVE,
VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_TRUE_VIEW_IN_STREAM,
YOUTUBE_AUDIO`

### Return values:

| Type | Description |
|---|---|
| `String` | Video ad group type. |

## `getEntityType()`

Returns the type of this entity as a `String`, in this case, `"VideoAdGroup"`.

### Return values:

| Type | Description |
|---|---|
| `String` | Type of this entity: `"VideoAdGroup"`. |

## `getId()`

Returns the ID of the video ad group.

### Return values:

| Type | Description |
|---|---|
| `String` | The ID of the video ad group. |

## `getName()`

Returns the name of the ad group.

### Return values:

| Type | Description |
|---|---|
| `String` | Name of the ad group. |

## `getResourceName()`

Returns the resource name of the video ad group.

### Return values:

| Type | Description |
|---|---|
| `String` | The resource name of the video ad group. |

## `getStatsFor(dateRange)`

Returns stats for the specified date range. Supported values:

`TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME`.

Example:

```
var stats = videoAdGroup.getStatsFor("THIS_MONTH");
```

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateRange | `String` | Date range for which the stats are requested. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getStatsFor(dateFrom, dateTo)`

Returns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` form. For instance, `March 24th,
2013` is represented as either `{year: 2013, month: 3, day:
24}` or `"20130324"`. The date range is inclusive on both ends, so `forDateRange("20130324", "20130324")` defines a range of a single day.

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateFrom | `Object` | Start date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |
| dateTo | `Object` | End date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getTopContentBidModifier()`

> [!WARNING]
> **Deprecated:** This method is deprecated and will be removed soon.

Returns the top content bid modifier for this ad group.

Top content bid modifiers are multipliers applied to the ad group's bids
for high quality content in network. For instance, a top content bid
modifier of `1.1` increases a bid to 110% of its original value
on mobile devices, and changes a bid of $5.00 to $5.50. The Google Ads UI
would render this setting as +10%.

### Return values:

| Type | Description |
|---|---|
| `double` | The top content bid modifier. |

## `getVideoCampaign()`

Returns the campaign to which this video ad group belongs.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaign` | The campaign to which this video ad group belongs. |

## `isEnabled()`

Returns `true` if the video ad group is enabled.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true` if the video ad group is enabled. |

## `isPaused()`

Returns `true` if the video ad group is paused.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true` if the video ad group is paused. |

## `isRemoved()`

Returns `true` if the ad group is removed.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true` if the ad group is removed. |

## `labels()`

Creates a selector of all labels applied to the video ad group.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_labelselector` | Selector of all labels applied to the video ad group. |

## `newVideoAd()`

Returns a new video ad builder space associated with this ad group.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadbuilderspace` | A new video ad builder space associated with this ad group. |

## `pause()`

Pauses the video ad group.

Returns nothing.

## `removeLabel(name)`

Removes a label from the video ad group. `name` of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| name | `String` | Name of the label. |

## `setName(name)`

Sets the name of the ad group.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| name | `String` | The new name for the ad group. |

## `setTopContentBidModifier(modifier)`

> [!WARNING]
> **Deprecated:** This method is deprecated and will be removed soon.

Sets the top content bid modifier for this ad group to the specified value. Bid modifiers must be between `1.0` and `6.0`.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| modifier | `double` | The new top content bid modifier. |

## `videoAds()`

Returns the selector of all ads in the video ad group.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoadselector` | The selector of all ads in the video ad group. |

## `videoTargeting()`

Provides access to this ad group's video targeting criteria. For details about video targeting, please see [About targeting for
video campaigns](https://support.google.com/google-ads/answer/2454017).

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroupvideotargeting` | Access to this ad group's video criteria. |