Builder for [VideoAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudience) objects. For details about video audiences, please see [About targeting for
video campaigns](https://support.google.com/google-ads/answer/2454017).

Example usage:

```
var videoAudienceBuilder = videoAdGroup
  .videoTargeting()
  .newAudienceBuilder();
var videoAudienceOperation = videoAudienceBuilder
  .withAudienceType('USER_INTEREST')   // required
  .withAudienceId(80432)               // required
  .build();                            // create the audience
```

### Methods:

| Member | Type | Description |
|---|---|---|
| [build()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder#build) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudienceoperation` | Builds the video audience. |
| [exclude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder#exclude) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedvideoaudienceoperation` | Builds the excluded video audience. |
| [withAudienceId(audienceId)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder#withAudienceId_audienceId) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder` | Sets the ID of the excluded audience. |
| [withAudienceType(audienceType)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder#withAudienceType_audienceType) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder` | Sets the type of the audience. |

## `build()`

Builds the video audience. Returns a [VideoAudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudienceoperation) that corresponds to the creation of the [VideoAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudience).

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudienceoperation` | The VideoAudienceOperation. |

## `exclude()`

Builds the excluded video audience. Returns an [ExcludedVideoAudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedvideoaudienceoperation) that corresponds to the creation of the [ExcludedVideoAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedvideoaudience).

Custom affinities cannot be excluded.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedvideoaudienceoperation` | The ExcludedVideoAudienceOperation. |

## `withAudienceId(audienceId)`

Sets the ID of the excluded audience. This field is required. For user interests, affinity categories and corresponding IDs can be found on [API
documentation on affinity categories](https://developers.google.com/google-ads/api/reference/data/codes-formats#affinity-categories), and in-market categories and corresponding IDs can be found on [API
documentation on in-market categories](https://developers.google.com/google-ads/api/reference/data/codes-formats#in-market-categories). User List IDs (List IDs) are available on the details page of a User List (found under the Audiences section of the Shared Library).

### Arguments:

| Name | Type | Description |
|---|---|---|
| audienceId | `String` | The ID of the excluded audience. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder` | An audience builder with the specified audience ID. |

## `withAudienceType(audienceType)`

Sets the type of the audience. Possible values: `USER_INTEREST`, `USER_LIST` or `CUSTOM_AFFINITY`. This field is required.

### Arguments:

| Name | Type | Description |
|---|---|---|
| audienceType | `String` | The type of the excluded audience. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_videoaudiencebuilder` | An VideoAudienceBuilder with the specified audience type. |