Builder for [Audience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audience) objects.

Example usage:

```
var audienceBuilder = adGroup.display().newAudienceBuilder();
var audience = audienceBuilder
  .withAudienceType('USER_LIST')  // required
  .withAudienceId(3)              // required
  .withCpc(0.50)                  // optional
  .build()                        // create the audience
```

### Methods:

| Member | Type | Description |
|---|---|---|
| [build()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#build) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audienceoperation` | Builds the audience. |
| [exclude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#exclude) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceoperation` | Builds the excluded audience. |
| [withAudience(userList)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#withAudience_userList) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | Sets the user list of the audience. |
| [withAudienceId(audienceId)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#withAudienceId_audienceId) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | Sets the audience ID of the audience. |
| [withAudienceType(audienceType)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#withAudienceType_audienceType) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | Sets the type of the audience, either `USER_INTEREST` or `USER_LIST`. |
| [withCpc(cpc)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#withCpc_cpc) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | Sets the max CPC bid of the new audience to the specified value. |
| [withCpm(cpm)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder#withCpm_cpm) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | Sets the CPM bid of the new audience to the specified value. |

## `build()`

Builds the audience. Returns a [AudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audienceoperation) that corresponds to the creation of the [Audience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audience).

### Return values:

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

## `exclude()`

Builds the excluded audience. Returns an [ExcludedAudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceoperation) that corresponds to the creation of the [ExcludedAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudience).

### Return values:

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

## `withAudience(userList)`

Sets the user list of the audience.

### Arguments:

| Name | Type | Description |
|---|---|---|
| userList | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_userlist` | The user list of the audience. |

### Return values:

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

## `withAudienceId(audienceId)`

Sets the audience ID of the audience. This field is required. 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 audience ID of the audience. |

### Return values:

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

## `withAudienceType(audienceType)`

Sets the type of the audience, either `USER_INTEREST` or `USER_LIST`. This field is required.

### Arguments:

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

### Return values:

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

## `withCpc(cpc)`

Sets the max CPC bid of the new audience to the specified value.

### Arguments:

| Name | Type | Description |
|---|---|---|
| cpc | `double` | The max CPC bid of the audience. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | The audience builder with the specified max CPC. |

## `withCpm(cpm)`

Sets the CPM bid of the new audience to the specified value.

See [Cost-per-thousand
impressions (CPM)](https://support.google.com/google-ads/answer/6310) for more information.

### Arguments:

| Name | Type | Description |
|---|---|---|
| cpm | `double` | The CPM bid of the audience. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_audiencebuilder` | The audience builder with the specified CPM. |