Represents a responsive ad for Display.

### Methods:

| Member | Type | Description |
|---|---|---|
| [applyLabel(name)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#applyLabel_name) | `void` | Applies a label to the ad. |
| [asType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#asType) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adviewspace` | Returns an [AdViewSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adviewspace), which provides access to type-specific fields of the ad. |
| [enable()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#enable) | `void` | Enables the ad. |
| [getAdGroup()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getAdGroup) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adgroup` | Returns the ad group to which this ad belongs. |
| [getBusinessName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getBusinessName) | `String` | Returns the ad's optional business name. |
| [getCampaign()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getCampaign) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign` | Returns the campaign to which this ad belongs or `null` if it does not belong to a search or display campaign. |
| [getDescription()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getDescription) | `String` | Returns the description of the ad if this is a legacy responsive display ad, or `null` if not. |
| [getDescriptions()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getDescriptions) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtextasset` | Returns the descriptions of the ad, or `null` if this is a legacy responsive display ad. |
| [getEntityType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getEntityType) | `String` | Returns the type of this entity as a `String`, in this case, `"Ad"`. |
| [getHeadlines()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getHeadlines) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtextasset` | Returns the short-format headlines of the ad, or `null` if this is a legacy responsive display ad. |
| [getId()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getId) | `String` | Returns the ID of the ad. |
| [getLandscapeLogoImages()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getLandscapeLogoImages) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | Returns the ad's landscape logo image assets, or `null` if the ad has none or if the ad is a legacy responsive display ad. |
| [getLogoImages()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getLogoImages) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | Returns the ad's square logo image assets, or `null` if the ad has none or if the ad is a legacy responsive display ad. |
| [getLongHeadline()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getLongHeadline) | `String` | Returns the long headline of the ad. |
| [getMarketingImages()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getMarketingImages) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | Returns the ad's rectangular marketing image assets, or `null` if this is a legacy responsive display ad. |
| [getPolicyApprovalStatus()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getPolicyApprovalStatus) | `String` | Returns the policy approval status of the ad. |
| [getPolicyTopics()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getPolicyTopics) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_policytopic` | Returns the list of policy topics associated with the ad. |
| [getResourceName()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getResourceName) | `String` | Returns the resource name of the ad. |
| [getShortHeadline()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getShortHeadline) | `String` | Returns the short headline of the ad if this is a legacy responsive display ad, or `null` if not. |
| [getSquareMarketingImages()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getSquareMarketingImages) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | Returns the ad's square marketing image assets, or `null` if this is a legacy responsive display ad. |
| [getStatsFor(dateRange)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#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_responsivedisplayad#getStatsFor_dateFrom-dateTo) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_stats` | Returns stats for the specified custom date range. |
| [getType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getType) | `String` | Returns the type of the ad. |
| [getYouTubeVideos()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#getYouTubeVideos) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | Returns the ad's YouTube video assets, or `null` if the ad has none or if the ad is a legacy responsive display ad. |
| [isEnabled()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#isEnabled) | `boolean` | Returns `true` if the ad is enabled. |
| [isLegacy()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#isLegacy) | `boolean` | Returns `true` if this is a legacy responsive display ad, `false` otherwise. |
| [isPaused()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#isPaused) | `boolean` | Returns `true` if the ad is paused. |
| [isType()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#isType) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtypespace` | Returns an [AdTypeSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtypespace), which determines the type of the ad. |
| [labels()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#labels) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_labelselector` | Creates a selector of all labels applied to the ad. |
| [pause()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#pause) | `void` | Pauses the ad. |
| [remove()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#remove) | `void` | Removes the ad. |
| [removeLabel(name)](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#removeLabel_name) | `void` | Removes a label from the ad. |
| [urls()](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#urls) | `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adurls` | Provides access to this ad's URL fields. |

## `applyLabel(name)`

Applies a label to the ad. `name` of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.

Note that the ad cannot have more than 50 labels.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| name | `String` | Name of the label to apply. |

## `asType()`

Returns an [AdViewSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adviewspace), which provides access to type-specific fields of the ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adviewspace` | An [AdViewSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adviewspace). |

## `enable()`

Enables the ad.

Returns nothing.

## `getAdGroup()`

Returns the ad group to which this ad belongs.

### Return values:

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

## `getBusinessName()`

Returns the ad's optional business name.

### Return values:

| Type | Description |
|---|---|
| `String` | The ad's business name. |

## `getCampaign()`

Returns the campaign to which this ad 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 ad belongs or `null` if it does not belong to a search or display campaign. |

## `getDescription()`

Returns the description of the ad if this is a legacy responsive display ad, or `null` if not.

### Return values:

| Type | Description |
|---|---|
| `String` | The description of the ad. |

## `getDescriptions()`

Returns the descriptions of the ad, or `null` if this is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtextasset` | The descriptions of the ad. |

## `getEntityType()`

Returns the type of this entity as a `String`, in this case, `"Ad"`.

### Return values:

| Type | Description |
|---|---|
| `String` | Type of this entity: `"Ad"`. |

## `getHeadlines()`

Returns the short-format headlines of the ad, or `null` if this is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtextasset` | The short-format headlines of the ad. |

## `getId()`

Returns the ID of the ad.

Ad IDs may be shared across ad groups. In order to uniquely identify one
ad, one must specify both its ad group ID and its creative ID.

### Return values:

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

## `getLandscapeLogoImages()`

Returns the ad's landscape logo image assets, or `null` if the ad has none or if the ad is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | The asset IDs of all landscape logo images to be used in the ad. |

## `getLogoImages()`

Returns the ad's square logo image assets, or `null` if the ad has none or if the ad is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | The asset IDs of all square logo images to be used in the ad. |

## `getLongHeadline()`

Returns the long headline of the ad.

### Return values:

| Type | Description |
|---|---|
| `String` | The long headline of the ad. |

## `getMarketingImages()`

Returns the ad's rectangular marketing image assets, or `null` if this is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | The asset IDs of all rectangular marketing images to be used in the ad. |

## `getPolicyApprovalStatus()`

Returns the policy approval status of the ad. For a full list of policy approval statuses, please see the [Google
Ads API documentation on policy approval statuses](https://developers.google.com/google-ads/api/reference/rpc/latest/PolicyApprovalStatusEnum.PolicyApprovalStatus).

### Return values:

| Type | Description |
|---|---|
| `String` | The policy approval status of the ad. |

## `getPolicyTopics()`

Returns the list of policy topics associated with the ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_policytopic` | The policy topics of the ad. |

## `getResourceName()`

Returns the resource name of the ad.

### Return values:

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

## `getShortHeadline()`

Returns the short headline of the ad if this is a legacy responsive display ad, or `null` if not.

### Return values:

| Type | Description |
|---|---|
| `String` | The short headline of the ad. |

## `getSquareMarketingImages()`

Returns the ad's square marketing image assets, or `null` if this is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | The asset IDs of all square aspect ratio marketing images to be used in the ad. |

## `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 = ad.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. |

## `getType()`

Returns the type of the ad. Possible values: `EXPANDED_TEXT_AD,
IMAGE_AD, MOBILE_AD, MOBILE_IMAGE_AD, PRODUCT_AD, RICH_MEDIA_AD,
TEMPLATE_AD, TEXT_AD`.

We recommend using [ResponsiveDisplayAd.isType](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_responsivedisplayad#isType) for fully supported types.

### Return values:

| Type | Description |
|---|---|
| `String` | The type of the ad. |

## `getYouTubeVideos()`

Returns the ad's YouTube video assets, or `null` if the ad has none or if the ad is a legacy responsive display ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_asset` | The asset IDs of all YouTube videos used in the ad. |

## `isEnabled()`

Returns `true` if the ad is enabled.

### Return values:

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

## `isLegacy()`

Returns `true` if this is a legacy responsive display ad, `false` otherwise.

### Return values:

| Type | Description |
|---|---|
| `boolean` | Boolean indicator whether or not this is a legacy repsonsive display ad. |

## `isPaused()`

Returns `true` if the ad is paused.

### Return values:

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

## `isType()`

Returns an [AdTypeSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtypespace), which determines the type of the ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtypespace` | An [AdTypeSpace](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adtypespace). |

## `labels()`

Creates a selector of all labels applied to the ad.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_labelselector` | Selector of all labels applied to the ad. |

## `pause()`

Pauses the ad.

Returns nothing.

## `remove()`

Removes the ad.

Returns nothing.

## `removeLabel(name)`

Removes a label from the ad. `name` of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.

Returns nothing.

### Arguments:

| Name | Type | Description |
|---|---|---|
| name | `String` | Name of the label. |

## `urls()`

Provides access to this ad's URL fields. See [Using Upgraded
URLs](https://support.google.com/google-ads/answer/6049217) for more information.

### Return values:

| Type | Description |
|---|---|
| `https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_adurls` | Access to this ad's URL fields. |