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

Example usage:

```
var placementBuilder = adGroup.display().newPlacementBuilder()
    .withUrl("http://www.site.com")  // required
    .withCpc(0.50)                   // optional
    .build()                         // create the placement
```

### Methods:

| Member | Type | Description |
|---|---|---|
| [build()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder#build) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation` | Builds the placement. |
| [exclude()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder#exclude) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedplacementoperation` | Builds the excluded placement. |
| [withCpc(cpc)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder#withCpc_cpc) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder` | Sets the max CPC bid of the new placement to the specified value. |
| [withCpm(cpm)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder#withCpm_cpm) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder` | Sets the CPM bid of the new placement to the specified value. |
| [withUrl(url)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder#withUrl_url) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder` | Sets the URL of the placement. |

## `build()`

Builds the placement. Returns a [PlacementOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation) that corresponds to the creation of the [Placement](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement).

### Return values:

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

## `exclude()`

Builds the excluded placement. Returns an [ExcludedPlacementOperation](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedplacementoperation) that corresponds to the creation of the [ExcludedPlacement](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_excludedplacement).

### Return values:

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

## `withCpc(cpc)`

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

### Arguments:

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

### Return values:

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

## `withCpm(cpm)`

Sets the CPM bid of the new placement 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 placement. |

### Return values:

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

## `withUrl(url)`

Sets the URL of the placement. This field is required.

### Arguments:

| Name | Type | Description |
|---|---|---|
| url | `String` | The placement URL. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placementbuilder` | A PlacementBuilder with the specified URL. |