- [Resource: AdGroupAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdGroupAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdGroupAd.SCHEMA_REPRESENTATION)
- [DisplayVideoSourceAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DisplayVideoSourceAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DisplayVideoSourceAd.SCHEMA_REPRESENTATION)
- [MastheadAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#MastheadAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#MastheadAd.SCHEMA_REPRESENTATION)
- [YoutubeVideoDetails](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails.SCHEMA_REPRESENTATION)
- [VideoUnavailableReason](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoUnavailableReason)
- [VideoAspectRatio](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoAspectRatio)
- [InStreamAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#InStreamAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#InStreamAd.SCHEMA_REPRESENTATION)
- [CommonInStreamAttribute](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute.SCHEMA_REPRESENTATION)
- [ImageAsset](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset.SCHEMA_REPRESENTATION)
- [NonSkippableAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#NonSkippableAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#NonSkippableAd.SCHEMA_REPRESENTATION)
- [BumperAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#BumperAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#BumperAd.SCHEMA_REPRESENTATION)
- [AudioAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AudioAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AudioAd.SCHEMA_REPRESENTATION)
- [VideoDiscoveryAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoDiscoveryAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoDiscoveryAd.SCHEMA_REPRESENTATION)
- [Thumbnail](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Thumbnail)
- [VideoPerformanceAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoPerformanceAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoPerformanceAd.SCHEMA_REPRESENTATION)
- [DemandGenVideoAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenVideoAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenVideoAd.SCHEMA_REPRESENTATION)
- [CallToAction](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CallToAction)
- [DemandGenImageAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenImageAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenImageAd.SCHEMA_REPRESENTATION)
- [DemandGenCarouselAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenCarouselAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenCarouselAd.SCHEMA_REPRESENTATION)
- [CarouselCard](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CarouselCard)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CarouselCard.SCHEMA_REPRESENTATION)
- [DemandGenProductAd](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenProductAd)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenProductAd.SCHEMA_REPRESENTATION)
- [AdPolicy](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicy)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicy.SCHEMA_REPRESENTATION)
- [AdPolicyApprovalStatus](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyApprovalStatus)
- [AdPolicyReviewStatus](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyReviewStatus)
- [AdPolicyTopicEntry](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntry)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntry.SCHEMA_REPRESENTATION)
- [AdPolicyTopicEntryType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntryType)
- [AdPolicyDecisionType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyDecisionType)
- [AdPolicyEnforcementMeans](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyEnforcementMeans)
- [AdPolicyTopicEvidence](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidence)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidence.SCHEMA_REPRESENTATION)
- [TextList](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#TextList)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#TextList.SCHEMA_REPRESENTATION)
- [WebsiteList](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#WebsiteList)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#WebsiteList.SCHEMA_REPRESENTATION)
- [DestinationTextList](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationTextList)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationTextList.SCHEMA_REPRESENTATION)
- [DestinationMismatch](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationMismatch)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationMismatch.SCHEMA_REPRESENTATION)
- [AdPolicyTopicEvidenceDestinationMismatchUrlType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationMismatchUrlType)
- [DestinationNotWorking](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationNotWorking)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationNotWorking.SCHEMA_REPRESENTATION)
- [AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)
- [AdPolicyTopicEvidenceDestinationNotWorkingDeviceType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)
- [Trademark](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Trademark)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Trademark.SCHEMA_REPRESENTATION)
- [AdPolicyCriterionRestriction](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction.SCHEMA_REPRESENTATION)
- [LegalRemoval](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LegalRemoval)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LegalRemoval.SCHEMA_REPRESENTATION)
- [Dmca](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Dmca)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Dmca.SCHEMA_REPRESENTATION)
- [LocalLegal](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LocalLegal)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LocalLegal.SCHEMA_REPRESENTATION)
- [AdPolicyTopicEvidenceLegalRemovalComplaintType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceLegalRemovalComplaintType)
- [Counterfeit](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Counterfeit)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Counterfeit.SCHEMA_REPRESENTATION)
- [RegionalRequirements](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirements)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirements.SCHEMA_REPRESENTATION)
- [RegionalRequirementsEntry](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirementsEntry)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirementsEntry.SCHEMA_REPRESENTATION)
- [AdPolicyTopicConstraint](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicConstraint)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicConstraint.SCHEMA_REPRESENTATION)
- [AdPolicyCountryConstraintList](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList.SCHEMA_REPRESENTATION)
- [AdPolicyResellerConstraint](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyResellerConstraint)
- [AdPolicyGlobalCertificateMissingConstraint](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateMissingConstraint)
- [AdPolicyGlobalCertificateDomainMismatchConstraint](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateDomainMismatchConstraint)
- [AdPolicyTopicAppealInfo](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicAppealInfo)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicAppealInfo.SCHEMA_REPRESENTATION)
- [AdPolicyAppealType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyAppealType)
- [AdUrl](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrl)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrl.SCHEMA_REPRESENTATION)
- [AdUrlType](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrlType)
- [DcmTrackingInfo](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DcmTrackingInfo)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DcmTrackingInfo.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#METHODS_SUMMARY)

## Resource: AdGroupAd

A single ad associated with an ad group.

| JSON representation |
|---|
| ``` { "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicy`) }, "entityStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v4/EntityStatus`), "adUrls": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrl`) } ], "dcmTrackingInfo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DcmTrackingInfo`) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "displayVideoSourceAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DisplayVideoSourceAd`) }, "mastheadAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#MastheadAd`) }, "inStreamAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#InStreamAd`) }, "nonSkippableAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#NonSkippableAd`) }, "bumperAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#BumperAd`) }, "audioAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AudioAd`) }, "videoDiscoverAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoDiscoveryAd`) }, "videoPerformanceAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoPerformanceAd`) }, "demandGenVideoAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenVideoAd`) }, "demandGenImageAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenImageAd`) }, "demandGenCarouselAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenCarouselAd`) }, "demandGenProductAd": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenProductAd`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the ad. |
| `advertiserId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the advertiser the ad belongs to. |
| `adGroupAdId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the ad. Assigned by the system. |
| `adGroupId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Immutable. The unique ID of the ad group that the ad belongs to. |
| `displayName` | `string` Required. The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes. |
| `adPolicy` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicy`)`` Output only. The policy approval status of the ad. |
| `entityStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/EntityStatus`)`` Required. The entity status of the ad. |
| `adUrls[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrl`)`` Output only. List of URLs used by the ad. |
| `dcmTrackingInfo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DcmTrackingInfo`)`` Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty. |
| The details of the ad. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `displayVideoSourceAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DisplayVideoSourceAd`)`` Output only. Details of an ad sourced from a Display \& Video 360 creative. |
| `mastheadAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#MastheadAd`)`` Output only. Details of an [ad served on the YouTube Home feed](https://support.google.com/google-ads/answer/9709826). |
| `inStreamAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#InStreamAd`)`` Output only. Details of an [in-stream ad skippable after 5 seconds](https://support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. |
| `nonSkippableAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#NonSkippableAd`)`` Output only. Details of a [non-skippable short in-stream video ad](https://support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. |
| `bumperAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#BumperAd`)`` Output only. Details of a [non-skippable short video ad](https://support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. |
| `audioAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AudioAd`)`` Output only. Details of an [audio ad](https://support.google.com/displayvideo/answer/6274216) used for reach marketing objectives. |
| `videoDiscoverAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoDiscoveryAd`)`` Output only. Details of an [ad promoting a video](https://support.google.com/displayvideo/answer/6274216) that shows in places of discovery. |
| `videoPerformanceAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoPerformanceAd`)`` Output only. Details of an [ad used in a video action campaign](https://support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. |
| `demandGenVideoAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenVideoAd`)`` Details of a [Demand Gen video ad](https://support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#VideoAd). |
| `demandGenImageAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenImageAd`)`` Details of a [Demand Gen image ad](https://support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#ImageAd). |
| `demandGenCarouselAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenCarouselAd`)`` Details of a [Demand Gen carousel ad](https://support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#CarouselAd). |
| `demandGenProductAd` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DemandGenProductAd`)`` Details of a [Demand Gen product ad](https://support.google.com/displayvideo/answer/15598924?&sjid=11207068802760924844-NC#Product-onlyAd). |
| End of mutually exclusive fields. ||

## DisplayVideoSourceAd

The ad sourced from a DV360 creative.

| JSON representation |
|---|
| ``` { "creativeId": string } ``` |

| Fields ||
|---|---|
| `creativeId` | `string (https://developers.google.com/discovery/v1/type-format format)` The ID of the source creative. |

## MastheadAd

Details for a Masthead Ad.

| JSON representation |
|---|
| ``` { "video": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) }, "headline": string, "description": string, "videoAspectRatio": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoAspectRatio`), "autoplayVideoStartMillisecond": string, "autoplayVideoDuration": string, "callToActionButtonLabel": string, "callToActionFinalUrl": string, "callToActionTrackingUrl": string, "showChannelArt": boolean, "companionYoutubeVideos": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) } ] } ``` |

| Fields ||
|---|---|
| `video` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The YouTube video used by the ad. |
| `headline` | `string` The headline of the ad. |
| `description` | `string` The description of the ad. |
| `videoAspectRatio` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoAspectRatio`)`` The aspect ratio of the autoplaying YouTube video on the Masthead. |
| `autoplayVideoStartMillisecond` | `string (https://developers.google.com/discovery/v1/type-format format)` The amount of time in milliseconds after which the video will start to play. |
| `autoplayVideoDuration` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#duration` format)`` The duration of time the video will autoplay. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `"3.5s"`. |
| `callToActionButtonLabel` | `string` The text on the call-to-action button. |
| `callToActionFinalUrl` | `string` The destination URL for the call-to-action button. |
| `callToActionTrackingUrl` | `string` The tracking URL for the call-to-action button. |
| `showChannelArt` | `boolean` Whether to show a background or banner that appears at the top of a YouTube page. |
| `companionYoutubeVideos[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The videos that appear next to the Masthead Ad on desktop. Can be no more than two. |

## YoutubeVideoDetails

Details of a YouTube video.

| JSON representation |
|---|
| ``` { "id": string, "unavailableReason": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoUnavailableReason`), "videoAssetId": string } ``` |

| Fields ||
|---|---|
| `id` | `string` Output only. The YouTube video ID which can be searched on YouTube webpage. |
| `unavailableReason` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#VideoUnavailableReason`)`` The reason why the video data is not available. |
| `videoAssetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The YouTube video asset id. This is the `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adAssets#AdAsset.FIELDS.ad_asset_id` of an `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adAssets#AdAsset` resource. |

## VideoUnavailableReason

Possible reasons why a video could be unavailable.

| Enums ||
|---|---|
| `VIDEO_UNAVAILABLE_REASON_UNSPECIFIED` | Unknown or unspecified. |
| `VIDEO_UNAVAILABLE_REASON_PRIVATE` | The video is private. |
| `VIDEO_UNAVAILABLE_REASON_DELETED` | The video is deleted. |

## VideoAspectRatio

Possible aspect ratios for a YouTube video.

| Enums ||
|---|---|
| `VIDEO_ASPECT_RATIO_UNSPECIFIED` | Not specified or unknown. |
| `VIDEO_ASPECT_RATIO_WIDESCREEN` | The video is stretched and the top and bottom are cropped. |
| `VIDEO_ASPECT_RATIO_FIXED_16_9` | The video uses a fixed 16:9 aspect ratio. |

## InStreamAd

Details for an in-stream ad.

| JSON representation |
|---|
| ``` { "commonInStreamAttribute": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`) }, "customParameters": { string: string, ... } } ``` |

| Fields ||
|---|---|
| `commonInStreamAttribute` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`)`` Common ad attributes. |
| `customParameters` | `map (key: string, value: string)` The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |

## CommonInStreamAttribute

Common attributes for in-stream, non-skippable and bumper ads.

| JSON representation |
|---|
| ``` { "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) }, "companionBanner": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } } ``` |

| Fields ||
|---|---|
| `displayUrl` | `string` The webpage address that appears with the ad. |
| `finalUrl` | `string` The URL address of the webpage that people reach after they click the ad. |
| `trackingUrl` | `string` The URL address loaded in the background for tracking purposes. |
| `actionButtonLabel` | `string` The text on the call-to-action button. |
| `actionHeadline` | `string` The headline of the call-to-action banner. |
| `video` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The YouTube video of the ad. |
| `companionBanner` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The image which shows next to the video ad. |

## ImageAsset

Meta data of an image asset.

| JSON representation |
|---|
| ``` { "mimeType": string, "fullSize": { object (`https://developers.google.com/display-video/api/reference/rest/v4/Dimensions`) }, "fileSize": string, "assetId": string } ``` |

| Fields ||
|---|---|
| `mimeType` | `string` Output only. MIME type of the image asset. |
| `fullSize` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/Dimensions`)`` Output only. Metadata for this image at its original size. |
| `fileSize` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. File size of the image asset in bytes. |
| `assetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The unique ID of the asset. |

## NonSkippableAd

Details for a non-skippable ad.

| JSON representation |
|---|
| ``` { "commonInStreamAttribute": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`) }, "customParameters": { string: string, ... } } ``` |

| Fields ||
|---|---|
| `commonInStreamAttribute` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`)`` Common ad attributes. |
| `customParameters` | `map (key: string, value: string)` The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |

## BumperAd

Details for a bumper ad.

| JSON representation |
|---|
| ``` { "commonInStreamAttribute": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`) } } ``` |

| Fields ||
|---|---|
| `commonInStreamAttribute` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CommonInStreamAttribute`)`` Common ad attributes. |

## AudioAd

Details for an audio ad.

| JSON representation |
|---|
| ``` { "displayUrl": string, "finalUrl": string, "trackingUrl": string, "video": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) } } ``` |

| Fields ||
|---|---|
| `displayUrl` | `string` The webpage address that appears with the ad. |
| `finalUrl` | `string` The URL address of the webpage that people reach after they click the ad. |
| `trackingUrl` | `string` The URL address loaded in the background for tracking purposes. |
| `video` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The YouTube video of the ad. |

## VideoDiscoveryAd

Details for a video discovery ad.

| JSON representation |
|---|
| ``` { "headline": string, "description1": string, "description2": string, "video": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) }, "thumbnail": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Thumbnail`) } ``` |

| Fields ||
|---|---|
| `headline` | `string` The headline of ad. |
| `description1` | `string` First text line for the ad. |
| `description2` | `string` Second text line for the ad. |
| `video` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The YouTube video the ad promotes. |
| `thumbnail` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Thumbnail`)`` Thumbnail image used in the ad. |

## Thumbnail

Possible thumbnail options in Video Discovery Ads.

| Enums ||
|---|---|
| `THUMBNAIL_UNSPECIFIED` | Unknown or unspecified. |
| `THUMBNAIL_DEFAULT` | The default thumbnail, can be auto-generated or user-uploaded. |
| `THUMBNAIL_1` | Thumbnail 1, generated from the video. |
| `THUMBNAIL_2` | Thumbnail 2, generated from the video. |
| `THUMBNAIL_3` | Thumbnail 3, generated from the video. |

## VideoPerformanceAd

Details for a video performance ad.

| JSON representation |
|---|
| ``` { "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) } ], "customParameters": { string: string, ... }, "companionBanners": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } ], "businessName": string, "logo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` The URL address of the webpage that people reach after they click the ad. |
| `trackingUrl` | `string` The URL address loaded in the background for tracking purposes. |
| `actionButtonLabels[]` | `string` The list of text assets shown on the call-to-action button. |
| `headlines[]` | `string` The list of headlines shown on the call-to-action banner. |
| `longHeadlines[]` | `string` The list of long headlines shown on the call-to-action banner. |
| `descriptions[]` | `string` The list of descriptions shown on the call-to-action banner. |
| `displayUrlBreadcrumb1` | `string` The first piece after the domain in the display URL. |
| `displayUrlBreadcrumb2` | `string` The second piece after the domain in the display URL. |
| `domain` | `string` The domain of the display URL. |
| `videos[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` The list of YouTube video assets used by this ad. |
| `customParameters` | `map (key: string, value: string)` The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `companionBanners[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The list of companion banners used by this ad. |
| `businessName` | `string` Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `logo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The logo image used by this ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |

## DemandGenVideoAd

Details for a Demand Gen video ad.

| JSON representation |
|---|
| ``` { "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CallToAction`), "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "videos": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`) } ], "customParameters": { string: string, ... }, "companionBanner": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) }, "logo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) }, "finalMobileUrl": string, "finalUrlSuffix": string, "businessName": string } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` Required. The URL address of the webpage that people reach after they click the ad. |
| `trackingUrl` | `string` Output only. The URL address loaded in the background for tracking purposes. |
| `userSpecifiedTrackingUrl` | `string` Optional. The tracking URL specified by the user manually. |
| `callToAction` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CallToAction`)`` Required. The call-to-action button shown on the ad. The supported values are: - `AUTOMATED` - `LEARN_MORE` - `GET_QUOTE` - `APPLY_NOW` - `SIGN_UP` - `CONTACT_US` - `SUBSCRIBE` - `DOWNLOAD` - `BOOK_NOW` - `SHOP_NOW` - `BUY_NOW` - `DONATE_NOW` - `ORDER_NOW` - `PLAY_NOW` - `SEE_MORE` - `START_NOW` - `VISIT_SITE` - `WATCH_NOW` |
| `headlines[]` | `string` Required. The list of headlines shown on the ad. |
| `longHeadlines[]` | `string` Required. The list of long headlines shown on the ad. |
| `descriptions[]` | `string` Required. The list of descriptions shown on the ad. |
| `displayUrlBreadcrumb1` | `string` Optional. The first piece after the domain in the display URL. |
| `displayUrlBreadcrumb2` | `string` Optional. The second piece after the domain in the display URL. |
| `videos[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#YoutubeVideoDetails`)`` Required. The list of YouTube video assets used by this ad. |
| `customParameters` | `map (key: string, value: string)` Optional. The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `companionBanner` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The companion banner used by this ad. |
| `logo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The logo image used by this ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `finalMobileUrl` | `string` Optional. The URL address of the webpage that people reach after they click the ad on a mobile device. |
| `finalUrlSuffix` | `string` Optional. The suffix to append to landing page URLs. |
| `businessName` | `string` Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |

## CallToAction

Possible call-to-action values for Demand Gen Product/Video ads.

| Enums ||
|---|---|
| `CALL_TO_ACTION_UNSPECIFIED` | Not specified or unknown. |
| `AUTOMATED` | Automated. |
| `LEARN_MORE` | Learn more. |
| `GET_QUOTE` | Get quote. |
| `APPLY_NOW` | Apply now. |
| `SIGN_UP` | Sign up. |
| `CONTACT_US` | Contact us. |
| `SUBSCRIBE` | Subscribe. |
| `DOWNLOAD` | Download. |
| `BOOK_NOW` | Book now. |
| `SHOP_NOW` | Shop now. |
| `BUY_NOW` | Buy now. |
| `DONATE_NOW` | Donate now. |
| `ORDER_NOW` | Order now. |
| `PLAY_NOW` | Play now. |
| `SEE_MORE` | See more. |
| `START_NOW` | Start now. |
| `VISIT_SITE` | Visit site. |
| `WATCH_NOW` | Watch now. |

## DemandGenImageAd

Details for a Demand Gen image ad.

| JSON representation |
|---|
| ``` { "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": string, "headlines": [ string ], "descriptions": [ string ], "customParameters": { string: string, ... }, "finalMobileUrl": string, "finalUrlSuffix": string, "businessName": string, "marketingImages": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } ], "squareMarketingImages": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } ], "portraitMarketingImages": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } ], "logoImages": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } ] } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` Required. The URL address of the webpage that people reach after they click the ad. |
| `trackingUrl` | `string` Output only. The URL address loaded in the background for tracking purposes. |
| `userSpecifiedTrackingUrl` | `string` Optional. The tracking URL specified by the user manually. |
| `callToAction` | `string` Required. The call-to-action button shown on the ad. |
| `headlines[]` | `string` Required. The list of headlines shown on the ad. |
| `descriptions[]` | `string` Required. The list of descriptions shown on the ad. |
| `customParameters` | `map (key: string, value: string)` Optional. The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `finalMobileUrl` | `string` Optional. The URL address of the webpage that people reach after they click the ad on a mobile device. |
| `finalUrlSuffix` | `string` Optional. The suffix to append to landing page URLs. |
| `businessName` | `string` Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `marketingImages[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The list of marketing images shown on the ad. |
| `squareMarketingImages[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The list of square marketing images shown on the ad. |
| `portraitMarketingImages[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The list of portrait marketing images shown on the ad. |
| `logoImages[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` The list of logo images shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |

## DemandGenCarouselAd

Details for a Demand Gen carousel ad.

| JSON representation |
|---|
| ``` { "finalUrl": string, "headline": string, "description": string, "cards": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CarouselCard`) } ], "finalUrlSuffix": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "businessName": string, "customParameters": { string: string, ... }, "logo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` Required. The URL address of the webpage that people reach after they click the ad. |
| `headline` | `string` Required. The headline of the ad. |
| `description` | `string` Required. The description of the ad. |
| `cards[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CarouselCard`)`` Required. The list of cards shown on the ad. |
| `finalUrlSuffix` | `string` Optional. The suffix to append to landing page URLs. |
| `trackingUrl` | `string` Output only. The URL address loaded in the background for tracking purposes. |
| `userSpecifiedTrackingUrl` | `string` Optional. The tracking URL specified by the user manually. |
| `businessName` | `string` Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `customParameters` | `map (key: string, value: string)` Optional. The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `logo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The logo image used by this ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |

## CarouselCard

Details for a Demand Gen carousel card.

| JSON representation |
|---|
| ``` { "finalUrl": string, "finalMobileUrl": string, "headline": string, "callToAction": string, "marketingImage": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) }, "squareMarketingImage": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) }, "portraitMarketingImage": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) } } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` Required. The URL address of the webpage that people reach after they click the card. |
| `finalMobileUrl` | `string` Optional. The URL address of the webpage that people reach after they click the card on a mobile device. |
| `headline` | `string` Required. The headline of the card. |
| `callToAction` | `string` Required. The text on the call-to-action button shown on the card. Must use 10 characters or less. |
| `marketingImage` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The marketing image shown on the card. |
| `squareMarketingImage` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The square marketing image shown on the card. |
| `portraitMarketingImage` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The portrait marketing image shown on the card. |

## DemandGenProductAd

Details for a Demand Gen product ad.

| JSON representation |
|---|
| ``` { "finalUrl": string, "headline": string, "description": string, "finalUrlSuffix": string, "callToAction": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CallToAction`), "trackingUrl": string, "userSpecifiedTrackingUrl": string, "businessName": string, "customParameters": { string: string, ... }, "logo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`) }, "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string } ``` |

| Fields ||
|---|---|
| `finalUrl` | `string` Required. The URL address of the webpage that people reach after they click the ad. |
| `headline` | `string` Required. The headline of the ad. |
| `description` | `string` Required. The description of the ad. |
| `finalUrlSuffix` | `string` Optional. The suffix to append to landing page URLs. |
| `callToAction` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#CallToAction`)`` Required. The call-to-action button shown on the ad. The supported values are: - `AUTOMATED` - `APPLY_NOW` - `BOOK_NOW` - `CONTACT_US` - `DOWNLOAD` - `GET_QUOTE` - `LEARN_MORE` - `SHOP_NOW` - `SIGN_UP` - `SUBSCRIBE` |
| `trackingUrl` | `string` Output only. The URL address loaded in the background for tracking purposes. |
| `userSpecifiedTrackingUrl` | `string` Optional. The tracking URL specified by the user manually. |
| `businessName` | `string` Optional. The business name shown on the ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `customParameters` | `map (key: string, value: string)` Optional. The custom parameters and accompanying values to add to the tracking URL. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `logo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#ImageAsset`)`` Optional. The logo image used by this ad. This setting is required unless a default value is set at the advertiser level. If left unset, the default value will be applied. |
| `displayUrlBreadcrumb1` | `string` Optional. The first piece after the domain in the display URL. |
| `displayUrlBreadcrumb2` | `string` Optional. The second piece after the domain in the display URL. |

## AdPolicy

A single ad policy associated with an ad group ad.

| JSON representation |
|---|
| ``` { "adPolicyApprovalStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyApprovalStatus`), "adPolicyReviewStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyReviewStatus`), "adPolicyTopicEntry": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntry`) } ] } ``` |

| Fields ||
|---|---|
| `adPolicyApprovalStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyApprovalStatus`)`` The policy approval status of an ad, indicating the approval decision. |
| `adPolicyReviewStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyReviewStatus`)`` The policy review status of an ad, indicating where in the review process the ad is currently. |
| `adPolicyTopicEntry[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntry`)`` The entries for each policy topic identified as relating to the ad. Each entry includes the topic, restriction level, and guidance on how to fix policy issues. |

## AdPolicyApprovalStatus

Possible statuses of an ad policy approval.

| Enums ||
|---|---|
| `AD_POLICY_APPROVAL_STATUS_UNKNOWN` | Unknown or not specified. |
| `DISAPPROVED` | Will not serve. |
| `APPROVED_LIMITED` | Will serve with restrictions. |
| `APPROVED` | Will serve without restrictions. |
| `AREA_OF_INTEREST_ONLY` | Will not serve in targeted countries, but may serve for users who are searching for information about the targeted countries. |

## AdPolicyReviewStatus

Possible statuses of an ad policy review.

| Enums ||
|---|---|
| `AD_POLICY_REVIEW_STATUS_UNKNOWN` | Unknown or not specified. |
| `REVIEW_IN_PROGRESS` | Currently under review. |
| `REVIEWED` | Primary review complete. Other reviews may still be in progress. |
| `UNDER_APPEAL` | Resubmitted for approval or a policy decision has been appealed. |
| `ELIGIBLE_MAY_SERVE` | Deemed eligible and may be serving. Further review could still follow. |

## AdPolicyTopicEntry

An entry describing how an ad has been identified as relating to an ad policy.

| JSON representation |
|---|
| ``` { "policyTopic": string, "policyLabel": string, "policyTopicDescription": string, "policyTopicType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntryType`), "policyDecisionType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyDecisionType`), "policyEnforcementMeans": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyEnforcementMeans`), "policyTopicEvidences": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidence`) } ], "policyTopicConstraints": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicConstraint`) } ], "helpCenterLink": string, "appealInfo": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicAppealInfo`) } } ``` |

| Fields ||
|---|---|
| `policyTopic` | `string` The policy topic. Examples include "TRADEMARKS", "ALCOHOL", etc. |
| `policyLabel` | `string` Localized label text for policy. Examples include "Trademarks in text", "Contains Alcohol", etc. |
| `policyTopicDescription` | `string` A short summary description of the policy topic. |
| `policyTopicType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEntryType`)`` How ad serving will be affected due to the relation to the ad policy topic. |
| `policyDecisionType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyDecisionType`)`` The source of the policy decision. |
| `policyEnforcementMeans` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyEnforcementMeans`)`` The policy enforcement means used in the policy review. |
| `policyTopicEvidences[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidence`)`` The evidence used in the policy decision. |
| `policyTopicConstraints[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicConstraint`)`` The serving constraints relevant to the policy decision. |
| `helpCenterLink` | `string` Ad policy help center link for the policy topic. |
| `appealInfo` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicAppealInfo`)`` Information on how to appeal the policy decision. |

## AdPolicyTopicEntryType

Possible serving impacts of an ad policy topic.

| Enums ||
|---|---|
| `AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN` | Unknown or not specified. |
| `PROHIBITED` | The resource will not serve. |
| `FULLY_LIMITED` | The resource will not serve in all targeted countries. |
| `LIMITED` | The resource cannot serve in some countries. |
| `DESCRIPTIVE` | The resource can serve. |
| `BROADENING` | The resource can serve, and may serve beyond normal coverage. |
| `AREA_OF_INTEREST_ONLY` | The resource is constrained for all targeted countries, but may serve for users who are searching for information about the targeted countries. |

## AdPolicyDecisionType

Possible sources of a policy decision.

| Enums ||
|---|---|
| `AD_POLICY_DECISION_TYPE_UNKNOWN` | Unknown or not specified. |
| `PURSUANT_TO_NOTICE` | The decision is from a legal notice, court order, or trademark content owner complaint, etc. |
| `GOOGLE_INVESTIGATION` | The decision is from a Google-owned investigation. |

## AdPolicyEnforcementMeans

Possible policy enforcement means used in the policy review.

| Enums ||
|---|---|
| `AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN` | Unknown or not specified. |
| `AUTOMATED` | The enforcement process was fully automated. |
| `HUMAN_REVIEW` | A human was partially or fully involved in the decision enforcement process. |

## AdPolicyTopicEvidence

Evidence information used in the policy decision.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "textList": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#TextList`) }, "websiteList": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#WebsiteList`) }, "httpCode": integer, "languageCode": string, "destinationTextList": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationTextList`) }, "destinationMismatch": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationMismatch`) }, "destinationNotWorking": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationNotWorking`) }, "trademark": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Trademark`) }, "legalRemoval": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LegalRemoval`) }, "counterfeit": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Counterfeit`) }, "regionalRequirements": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirements`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| The evidence for the policy decision. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `textList` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#TextList`)`` List of evidence found in the text of the ad. |
| `websiteList` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#WebsiteList`)`` List of websites linked with the ad. |
| `httpCode` | `integer` HTTP code returned when the final URL was crawled. |
| `languageCode` | `string` The language the ad was detected to be written in. This field uses IETF language tags, such as "en-US". |
| `destinationTextList` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationTextList`)`` The text in the destination of the ad that is causing a policy violation. |
| `destinationMismatch` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationMismatch`)`` A mismatch between the ad destination URLs. |
| `destinationNotWorking` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#DestinationNotWorking`)`` Information on HTTP or DNS errors related to the ad destination. |
| `trademark` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Trademark`)`` Trademark terms that caused a policy violation. |
| `legalRemoval` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LegalRemoval`)`` Legal related regulation enforcement that caused a policy violation. |
| `counterfeit` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Counterfeit`)`` Counterfeit enforcement that caused a policy violation. |
| `regionalRequirements` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirements`)`` T\&S proactive enforcement that caused a policy violation. |
| End of mutually exclusive fields. ||

## TextList

A list of fragments of text that violated the policy.

| JSON representation |
|---|
| ``` { "texts": [ string ] } ``` |

| Fields ||
|---|---|
| `texts[]` | `string` The fragments of text from the resource that caused the policy finding. |

## WebsiteList

A list of websites that violated the policy.

| JSON representation |
|---|
| ``` { "websites": [ string ] } ``` |

| Fields ||
|---|---|
| `websites[]` | `string` Websites that caused the policy finding. |

## DestinationTextList

A list of destination text that violated the policy.

| JSON representation |
|---|
| ``` { "destinationTexts": [ string ] } ``` |

| Fields ||
|---|---|
| `destinationTexts[]` | `string` Destination text that caused the policy finding. |

## DestinationMismatch

Details on a mismatch between destination URL types.

| JSON representation |
|---|
| ``` { "uriTypes": [ enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationMismatchUrlType`) ] } ``` |

| Fields ||
|---|---|
| `uriTypes[]` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationMismatchUrlType`)`` The set of URLs that do not match. The list can include single or multiple uri types. Example 1: \[`DISPLAY_URL`, `FINAL_URL`\] means ad display URL does not match with the ad final URL. Example 2: \[`FINAL_URL`\] means ad final URL did not match the crawled url, which is also considered as destination mismatch. |

## AdPolicyTopicEvidenceDestinationMismatchUrlType

Possible URL types.

| Enums ||
|---|---|
| `AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN` | Not specified or unknown. |
| `DISPLAY_URL` | The display URL. |
| `FINAL_URL` | The final URL. |
| `FINAL_MOBILE_URL` | The final mobile URL. |
| `TRACKING_URL` | The tracking URL. |
| `MOBILE_TRACKING_URL` | The mobile tracking URL. |

## DestinationNotWorking

Details for on HTTP or DNS errors related to the ad destination.

| JSON representation |
|---|
| ``` { "expandedUri": string, "device": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDeviceType`), "lastCheckedTime": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "dnsErrorType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType`), "httpErrorCode": string // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `expandedUri` | `string` The full URL that didn't work. |
| `device` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDeviceType`)`` The device where visiting the URL resulted in the error. |
| `lastCheckedTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The last time the error was seen when navigating to URL. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| The HTTP or DNS error. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `dnsErrorType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType`)`` The type of DNS error. |
| `httpErrorCode` | `string (https://developers.google.com/discovery/v1/type-format format)` The HTTP error code. |
| End of mutually exclusive fields. ||

## AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Possible DNS error types.

| Enums ||
|---|---|
| `AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN` | Not specified or unknown. |
| `HOSTNAME_NOT_FOUND` | Host name not found in DNS when fetching landing page. |
| `GOOGLE_CRAWLER_DNS_ISSUE` | Google could not crawl the landing page when communicating with DNS. |

## AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Possible devices that that saw an error when visiting the URL.

| Enums ||
|---|---|
| `AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN` | Not specified or unknown. |
| `DESKTOP` | Desktop device. |
| `ANDROID` | Android device. |
| `IOS` | iOS device. |

## Trademark

Trademark terms that caused a policy violation.

| JSON representation |
|---|
| ``` { "owner": string, "term": string, "countryRestrictions": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`) } ] } ``` |

| Fields ||
|---|---|
| `owner` | `string` The trademark content owner. |
| `term` | `string` The trademark term. |
| `countryRestrictions[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`)`` Countries where the policy violation is relevant. |

## AdPolicyCriterionRestriction

Represents a country restriction.

| JSON representation |
|---|
| ``` { "countryCriterionId": string, "countryLabel": string } ``` |

| Fields ||
|---|---|
| `countryCriterionId` | `string (https://developers.google.com/discovery/v1/type-format format)` The country criterion id. |
| `countryLabel` | `string` Localized name for the country. May be empty. |

## LegalRemoval

Legal related regulation enforcement, either from DMCA or local legal regulation.

| JSON representation |
|---|
| ``` { "complaintType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceLegalRemovalComplaintType`), "countryRestrictions": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`) } ], "restrictedUris": [ string ], // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "dmca": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Dmca`) }, "localLegal": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LocalLegal`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `complaintType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicEvidenceLegalRemovalComplaintType`)`` The type of complaint causing the legal removal. |
| `countryRestrictions[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`)`` The countries restricted due to the legal removal. |
| `restrictedUris[]` | `string` The urls restricted due to the legal removal. |
| Details on the type of legal removal. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `dmca` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#Dmca`)`` Details on the DMCA regulation legal removal. |
| `localLegal` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#LocalLegal`)`` Details on the local legal regulation legal removal. |
| End of mutually exclusive fields. ||

## Dmca

DMCA complaint details.

| JSON representation |
|---|
| ``` { "complainant": string } ``` |

| Fields ||
|---|---|
| `complainant` | `string` The entity who made the legal complaint. |

## LocalLegal

Local legal regulation details.

| JSON representation |
|---|
| ``` { "lawType": string } ``` |

| Fields ||
|---|---|
| `lawType` | `string` Type of law for the legal notice. |

## AdPolicyTopicEvidenceLegalRemovalComplaintType

Possible complaint types for legal removal.

| Enums ||
|---|---|
| `AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN` | Not specified or unknown. |
| `COPYRIGHT` | Copyright. Only applies to DMCA. |
| `COURT_ORDER` | Court order. Only applies to local legal. |
| `LOCAL_LEGAL` | Local legal regulation. Only applies to local legal. |

## Counterfeit

Details on the counterfeit enforcement that caused a policy violation.

| JSON representation |
|---|
| ``` { "owners": [ string ] } ``` |

| Fields ||
|---|---|
| `owners[]` | `string` The content or product owners that made a complaint. |

## RegionalRequirements

Trust \& Safety (T\&S) proactive enforcement for policies meant to address regional requirements. This is considered a Google-owned investigation instead of a regulation notice since it's proactive T\&S enforcement.

| JSON representation |
|---|
| ``` { "regionalRequirementsEntries": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirementsEntry`) } ] } ``` |

| Fields ||
|---|---|
| `regionalRequirementsEntries[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#RegionalRequirementsEntry`)`` List of regional requirements. |

## RegionalRequirementsEntry

Policy level regional legal violation details.

| JSON representation |
|---|
| ``` { "legalPolicy": string, "countryRestrictions": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`) } ] } ``` |

| Fields ||
|---|---|
| `legalPolicy` | `string` The legal policy that is being violated. |
| `countryRestrictions[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`)`` The countries restricted due to the legal policy. |

## AdPolicyTopicConstraint

Details on ad serving constraints.

| JSON representation |
|---|
| ``` { "requestCertificateFormLink": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "countryConstraint": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`) }, "resellerConstraint": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyResellerConstraint`) }, "certificateMissingCountryList": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`) }, "certificateDomainMismatchCountryList": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`) }, "globalCertificateMissing": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateMissingConstraint`) }, "globalCertificateDomainMismatch": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateDomainMismatchConstraint`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `requestCertificateFormLink` | `string` Link to the form to request a certificate for the constraint. |
| The serving constraint. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `countryConstraint` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`)`` Countries where the ad cannot serve. |
| `resellerConstraint` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyResellerConstraint`)`` Reseller constraint. |
| `certificateMissingCountryList` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`)`` Countries where a certificate is required for serving. |
| `certificateDomainMismatchCountryList` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCountryConstraintList`)`` Countries where the resource's domain is not covered by the certificates associated with it. |
| `globalCertificateMissing` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateMissingConstraint`)`` Certificate is required to serve in any country. |
| `globalCertificateDomainMismatch` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyGlobalCertificateDomainMismatchConstraint`)`` Certificate is required to serve in any country and the existing certificate does not cover the ad's domain. |
| End of mutually exclusive fields. ||

## AdPolicyCountryConstraintList

A list of countries where the ad cannot serve due to policy constraints.

| JSON representation |
|---|
| ``` { "countries": [ { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`) } ] } ``` |

| Fields ||
|---|---|
| `countries[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyCriterionRestriction`)`` Countries where the ad cannot serve. |

## AdPolicyResellerConstraint

This type has no fields.
Policy topic was constrained due to disapproval of the website for reseller purposes.

## AdPolicyGlobalCertificateMissingConstraint

This type has no fields.
Certificate is required to serve in any country.

## AdPolicyGlobalCertificateDomainMismatchConstraint

This type has no fields.
Certificate is required to serve in any country and the existing certificate does not cover the ad's domain.

## AdPolicyTopicAppealInfo

Information on how to appeal a policy decision.

| JSON representation |
|---|
| ``` { "appealType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyAppealType`), "appealFormLink": string } ``` |

| Fields ||
|---|---|
| `appealType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyAppealType`)`` Whether the decision can be appealed through a self-service appeal or an appeal form. |
| `appealFormLink` | `string` Only available when `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdPolicyTopicAppealInfo.FIELDS.appeal_type` is `APPEAL_FORM`. |

## AdPolicyAppealType

Possible types of appeal.

| Enums ||
|---|---|
| `AD_POLICY_APPEAL_TYPE_UNKNOWN` | Unknown or not specified. |
| `SELF_SERVICE_APPEAL` | The decision can be appealed through a self-service appeal. |
| `APPEAL_FORM` | The decision can be appealed using an appeal form. |

## AdUrl

Additional URLs related to the ad, including beacons.

| JSON representation |
|---|
| ``` { "type": enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrlType`), "url": string } ``` |

| Fields ||
|---|---|
| `type` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdUrlType`)`` The type of the Ad URL. |
| `url` | `string` The URL string value. |

## AdUrlType

Possible ad URL types.

| Enums ||
|---|---|
| `AD_URL_TYPE_UNSPECIFIED` | Unknown or unspecified. |
| `AD_URL_TYPE_BEACON_IMPRESSION` | A 1x1 tracking pixel to ping when an impression of a creative is delivered. |
| `AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION` | Expandable DCM impression beacon. At serving time, it is expanded to several beacons. |
| `AD_URL_TYPE_BEACON_CLICK` | Tracking URL to ping when the click event is triggered. |
| `AD_URL_TYPE_BEACON_SKIP` | Tracking URL to ping when the skip event is triggered. |

## DcmTrackingInfo

Details on the DCM tracking.

| JSON representation |
|---|
| ``` { "placementId": string, "trackingAdId": string, "creativeId": string } ``` |

| Fields ||
|---|---|
| `placementId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The DCM placement id. |
| `trackingAdId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The DCM tracking ad id. |
| `creativeId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The DCM creative id. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds/create` | Creates an ad group ad. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds/delete` | Deletes an ad group ad. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds/get` | Gets an ad group ad. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds/list` | Lists ad group ads. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adGroupAds/patch` | Updates an ad group ad. |