Fetches excluded audiences. Supports filtering and sorting.

Typical usage:

```
var adGroup = AdsApp.adGroups().get().next();
var excludedAudienceSelector = adGroup.display().excludedAudiences();

var excludedAudienceIterator = excludedAudienceSelector.get();
while (excludedAudienceIterator.hasNext()) {
  var excludedAudience = excludedAudienceIterator.next();
}
```
Related:

- [ExcludedAudienceIterator](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceiterator)
- [ExcludedAudience](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudience)

### Methods:

| Member | Type | Description |
|---|---|---|
| [get()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector#get) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceiterator` | Fetches the requested excluded audiences and returns an iterator. |
| [orderBy(orderBy)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector#orderBy_orderBy) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | Specifies the ordering of the resulting entities. |
| [withCondition(condition)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector#withCondition_condition) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | Adds the specified condition to the selector in order to narrow down the results. |
| [withLimit(limit)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector#withLimit_limit) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | Specifies limit for the selector to use. |

## `get()`

Fetches the requested excluded audiences and returns an iterator.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceiterator` | Iterator of the requested excluded audiences. |

## `orderBy(orderBy)`

Specifies the ordering of the resulting entities. `orderBy` parameter can have one of the following forms:

- `orderBy("ad_group.name")` - orders results by ad_group.name, in ascending order.
- `orderBy("ad_group.name ASC")` - orders results by ad_group.name, in ascending order.
- `orderBy("ad_group.name DESC")` - orders results by ad_group.name, in descending order.

See [ExcludedAudienceSelector.withCondition(String)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector#withCondition_condition)
for enumeration of columns that can be used.

`orderBy()` may be called multiple times. Consider the
following example:

```
selector = selector.
    .orderBy("campaign.name")
    .orderBy("ad_group.name");
```

The results will be ordered by campaign.name in ascending order. Results
with equal campaign.name value will be ordered by ad_group.name in
ascending order.

### Arguments:

| Name | Type | Description |
|---|---|---|
| orderBy | `String` | Ordering to apply. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | The selector with ordering applied. |

## `withCondition(condition)`

Adds the specified condition to the selector in order to narrow down the results.

Multiple conditions may be added to the same selector:

```
selector = selector
    .withCondition("ad_group.name REGEXP_MATCH 'a.*'")
    .withCondition("campaign.name = 'Campaign 1'");
```
All specified conditions are `AND`-ed together. The above example will retrieve excluded audiences of type `USER_LIST` whose ad group's name starts with 'a' and are in Campaign 1.

The parameter to be passed into this method must be of the following
form:

```
"COLUMN_NAME OPERATOR VALUE"
```

#### Operators

The operator that can be used in a condition depends on the type of column.

- For `String` columns (e.g. ad_group.name): **```
  = != (NOT) (LIKE | CONTAINS | REGEXP_MATCH)
  ```**
- For `Enumeration` columns (ones that can only take one value from a pre-defined list, such as ad_group.status): **```
  = != IN () NOT IN ()
  ```**

Conditions using `IN`, `NOT IN`, `CONTAINS
ALL`, `CONTAINS ANY` and `CONTAINS NONE` operators look as follows:

```
withCondition("ad_group.status IN (Value1, Value2)")
```

#### Columns

All column names are case-sensitive, and so are all values of enumerated
columns (such as ad_group.status)

| Column | Type | Example |
|---|---|---|
| *** Excluded audience attributes *** |||
| ad_group.name | String | `withCondition("ad_group.name REGEXP_MATCH '.*shoes.*'")` |
| ad_group.status | Enumeration: `ENABLED`, `PAUSED`, `REMOVED` | `withCondition("ad_group.status = ENABLED")`. Use to fetch excluded audiences from only `ENABLED` ad groups. |
| campaign.name | String | `withCondition("campaign.name REGEXP_MATCH '.*promotion.*'")` |
| campaign.status | Enumeration: `ENABLED`, `PAUSED`, `REMOVED` | `withCondition("campaign.status = ENABLED")`. Use to fetch excluded audiences from only `ENABLED` campaigns. |

### Arguments:

| Name | Type | Description |
|---|---|---|
| condition | `String` | Condition to add to the selector. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | The selector with the condition applied. |

## `withLimit(limit)`

Specifies limit for the selector to use. For instance, `withLimit(50)` returns only the first 50 entities.

### Arguments:

| Name | Type | Description |
|---|---|---|
| limit | `int` | How many entities to return. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedaudienceselector` | The selector with limit applied. |