Represents a Google Ads website placement.

Mobile app placements and mobile app category placements are not
supported.

### Methods:

| Member | Type | Description |
|---|---|---|
| [bidding()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#bidding) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_displaycriterionbidding` | Provides access to this placement's bidding fields. |
| [getAdGroup()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getAdGroup) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroup` | Returns the ad group to which this placement belongs. |
| [getBaseAdGroup()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getBaseAdGroup) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroup` | Returns the base ad group to which this placement belongs. |
| [getBaseCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getBaseCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | Returns the base campaign to which this placement belongs. |
| [getCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | Returns the campaign to which this placement belongs or `null` if it does not belong to a search or display campaign. |
| [getId()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getId) | `String` | Returns the ID of the placement. |
| [getResourceName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getResourceName) | `String` | Returns the resource name of the placement. |
| [getStatsFor(dateRange)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getStatsFor_dateRange) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified date range. |
| [getStatsFor(dateFrom, dateTo)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getStatsFor_dateFrom-dateTo) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified custom date range. |
| [getUrl()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#getUrl) | `String` | Returns the URL of the placement. |
| [isEnabled()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#isEnabled) | `boolean` | Returns `true` if the placement is enabled. |
| [isManaged()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#isManaged) | `boolean` | This method is deprecated and will always return `true`. |
| [isPaused()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#isPaused) | `boolean` | Returns `true` if the placement is paused. |
| [remove()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_placement#remove) | `void` | Removes the placement. |

## `bidding()`

Provides access to this placement's bidding fields.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_displaycriterionbidding` | Access to this placement's bidding fields. |

## `getAdGroup()`

Returns the ad group to which this placement belongs.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroup` | The ad group to which this placement belongs. |

## `getBaseAdGroup()`

Returns the base ad group to which this placement belongs.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroup` | The base ad group to which this placement belongs. |

## `getBaseCampaign()`

Returns the base campaign to which this placement belongs.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | The base campaign to which this placement belongs. |

## `getCampaign()`

Returns the campaign to which this placement belongs or `null` if it does not belong to a search or display campaign.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | The campaign to which this placement belongs or `null` if it does not belong to a search or display campaign. |

## `getId()`

Returns the ID of the placement.

Returns `0` if the placement is automatic.

### Return values:

| Type | Description |
|---|---|
| `String` | The ID of the placement. |

## `getResourceName()`

Returns the resource name of the placement.

### Return values:

| Type | Description |
|---|---|
| `String` | The resource name of the placement. |

## `getStatsFor(dateRange)`

Returns stats for the specified date range. Supported values:

`TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME`.

Example:

```
var stats = placement.getStatsFor("THIS_MONTH");
```

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateRange | `String` | Date range for which the stats are requested. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getStatsFor(dateFrom, dateTo)`

Returns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` form. For instance, `March 24th,
2013` is represented as either `{year: 2013, month: 3, day:
24}` or `"20130324"`. The date range is inclusive on both ends, so `forDateRange("20130324", "20130324")` defines a range of a single day.

### Arguments:

| Name | Type | Description |
|---|---|---|
| dateFrom | `Object` | Start date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |
| dateTo | `Object` | End date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties. |

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | The stats for the specified date range. |

## `getUrl()`

Returns the URL of the placement.

### Return values:

| Type | Description |
|---|---|
| `String` | The URL of the placement. |

## `isEnabled()`

Returns `true` if the placement is enabled.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true` if the placement is enabled. |

## `isManaged()`

This method is deprecated and will always return `true`. All placements returned by a `PlacementIterator` are managed.

> [!WARNING]
> **Deprecated.** This method will always return `true`.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true`. |

## `isPaused()`

Returns `true` if the placement is paused.

### Return values:

| Type | Description |
|---|---|
| `boolean` | `true` if the placement is paused. |

## `remove()`

Removes the placement.

Returns nothing.