Builder for [SearchCampaignAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudience) and [SearchCampaignExcludedAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignexcludedaudience) objects.

Example usage:

```
var audienceBuilder = campaign.targeting().newUserListBuilder();
var audienceOperation = audienceBuilder
    .withAudienceId(3)       // required
    .build();                // add the audience, or .exclude() to exclude
                             // the audience.
var audience = audienceOperation.getResult();
```

### Methods:

| Member | Type | Description |
|---|---|---|
| [build()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder#build) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudienceoperation` | Builds the audience. |
| [exclude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder#exclude) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignexcludedaudienceoperation` | Builds the excluded audience. |
| [withAudience(userList)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder#withAudience_userList) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder` | Sets the user list of the audience. |
| [withAudienceId(audienceId)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder#withAudienceId_audienceId) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder` | Sets the audience ID of the audience. |
| [withBidModifier(modifier)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder#withBidModifier_modifier) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder` | Sets the bid modifier value for this audience to the specified value. |

## `build()`

Builds the audience. Returns a [SearchCampaignAudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudienceoperation) that corresponds to the addition of the [SearchCampaignAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudience).

### Return values:

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

## `exclude()`

Builds the excluded audience. Returns a [SearchCampaignExcludedAudienceOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignexcludedaudienceoperation) that corresponds to the addition of the [SearchCampaignExcludedAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignexcludedaudience).

### Return values:

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

## `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_searchcampaignaudiencebuilder` | 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_searchcampaignaudiencebuilder` | An audience builder for the specified audience ID. |

## `withBidModifier(modifier)`

Sets the bid modifier value for this audience to the specified value.

The bid modifier is a multiplier applied to the audience's bids, with an
acceptable range from `0.1` (a `90%` decrease) to
`10.0` (a `900%` increase).

For more information about bid modifiers please see the [Google Ads Help
Center article](https://support.google.com/google-ads/answer/2732132). Use of this method when adding an excluded audience is
not supported.

### Arguments:

| Name | Type | Description |
|---|---|---|
| modifier | `double` | The bid modifier value. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_searchcampaignaudiencebuilder` | An audience builder configured to use the specified bid modifier. |