> [!WARNING]
> Display \& Video 360 API v5 is currently in beta.

- [Resource: YoutubeAssetAssociation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.SCHEMA_REPRESENTATION)
  - [YoutubeAssetType](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.YoutubeAssetType)
  - [LinkedYouTubeAsset](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LinkedYouTubeAsset)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LinkedYouTubeAsset.SCHEMA_REPRESENTATION)
  - [LocationAssetFilter](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.SCHEMA_REPRESENTATION)
  - [LocationMatchingType](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingType)
  - [LocationMatchingFunction](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingFunction)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingFunction.SCHEMA_REPRESENTATION)
  - [AffiliateLocationAssetFilter](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter.SCHEMA_REPRESENTATION)
  - [AffiliateLocationMatchingType](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingType)
  - [AffiliateLocationMatchingFunction](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingFunction)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingFunction.SCHEMA_REPRESENTATION)
  - [AffiliateLocationChain](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationChain)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationChain.SCHEMA_REPRESENTATION)
  - [SitelinkAsset](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.SitelinkAsset)
    - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.SitelinkAsset.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#METHODS_SUMMARY)

## Resource: YoutubeAssetAssociation

An association between a resource and a YouTube asset.

| JSON representation |
|---|
| ``` { "name": string, "youtubeAssetType": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.YoutubeAssetType`), "linkedYoutubeAsset": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LinkedYouTubeAsset`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the association. For line item-level associations: The name pattern is `advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}`. For ad group-level associations: The name pattern is `advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}`. For `YOUTUBE_ASSET_TYPE_LOCATION` and `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION` associations: `youtubeAssetAssociationId` is the ID of the asset set linked, or 0 if the `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.FIELDS.location_matching_type` or `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter.FIELDS.affiliate_location_matching_type` is `DISABLED`. For `YOUTUBE_ASSET_TYPE_SITELINK` associations: `youtubeAssetAssociationId` is be the ID of the sitelink asset linked. |
| `youtubeAssetType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.YoutubeAssetType`)`` Required. The type of YouTube asset associated with the resource. |
| `linkedYoutubeAsset` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LinkedYouTubeAsset`)`` Required. The YouTube asset associated with the resource. |

### YoutubeAssetType

Possible types of YouTube assets.

These assets will show additional information alongside ads during serving.

| Enums ||
|---|---|
| `YOUTUBE_ASSET_TYPE_UNSPECIFIED` | YouTube asset type is not specified or is unknown in this version. |
| `YOUTUBE_ASSET_TYPE_LOCATION` | Location asset. |
| `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION` | Affiliate location asset. |
| `YOUTUBE_ASSET_TYPE_SITELINK` | Sitelink asset. |

### LinkedYouTubeAsset

A YouTube asset linked to a resource in a `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation`.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "locationAssetFilter": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter`) }, "affiliateLocationAssetFilter": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter`) }, "sitelinkAsset": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.SitelinkAsset`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| The YouTube asset. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `locationAssetFilter` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter`)`` A location asset filter. This can be set only when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.FIELDS.youtube_asset_type` is `YOUTUBE_ASSET_TYPE_LOCATION`. |
| `affiliateLocationAssetFilter` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter`)`` An affiliate location asset filter. This can be set only when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.FIELDS.youtube_asset_type` is `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION`. |
| `sitelinkAsset` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.SitelinkAsset`)`` A sitelink asset. This can be set only when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.FIELDS.youtube_asset_type` is `YOUTUBE_ASSET_TYPE_SITELINK`. |
| End of mutually exclusive fields. ||

### LocationAssetFilter

An asset filter that matches eligible location assets for serving.

| JSON representation |
|---|
| ``` { "locationMatchingType": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingType`), "assetSetId": string, "locationMatchingFunction": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingFunction`) } } ``` |

| Fields ||
|---|---|
| `locationMatchingType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingType`)`` Required. The matching type of this location asset filter. |
| `assetSetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The ID of the asset set that matches the location assets eligible for serving. |
| `locationMatchingFunction` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationMatchingFunction`)`` Optional. The matching function that determines how the location asset filter matches location assets. This field is required and can only be set for if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.FIELDS.location_matching_type` is `FILTER` or `SELECTED_ASSETS`. |

### LocationMatchingType

Possible matching types that decide which location assets are eligible for serving.

| Enums ||
|---|---|
| `LOCATION_MATCHING_TYPE_UNSPECIFIED` | Location matching type is not specified or is unknown in this version. |
| `SELECT_ALL` | All available location assets are eligible for serving. |
| `FILTER` | The location assets that match a provided business name and/or label filters can serve. |
| `SELECTED_ASSETS` | Only the selected location assets can serve. |
| `DISABLED` | No location assets can serve. |

### LocationMatchingFunction

The matching function for a location asset filter.

| JSON representation |
|---|
| ``` { "labels": [ string ], "locationAssetIds": [ string ], "business": string } ``` |

| Fields ||
|---|---|
| `labels[]` | `string` Optional. The labels to match with. Labels are logically OR'ed together. This field is optional and can only be set if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.FIELDS.location_matching_type` is `FILTER`. |
| `locationAssetIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. The selected location asset IDs. This field is required if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.FIELDS.location_matching_type` is `SELECTED_ASSETS`. |
| `business` | `string` Optional. The business name to match with. This field is optional and can only be set if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.LocationAssetFilter.FIELDS.location_matching_type` is `FILTER`. |

### AffiliateLocationAssetFilter

An asset filter that matches eligible affiliate location assets for serving.

| JSON representation |
|---|
| ``` { "affiliateLocationMatchingType": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingType`), "assetSetId": string, "affiliateLocationMatchingFunction": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingFunction`) } } ``` |

| Fields ||
|---|---|
| `affiliateLocationMatchingType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingType`)`` Required. The matching type of this affiliate location asset filter. |
| `assetSetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The ID of the asset set that matches the affiliate location assets eligible for serving. |
| `affiliateLocationMatchingFunction` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationMatchingFunction`)`` Optional. The matching function that determines how the affiliate location asset filter matches affiliate location assets. This field is required and can only be set for if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter.FIELDS.affiliate_location_matching_type` is `SELECTED_CHAINS`. |

### AffiliateLocationMatchingType

Possible matching types that decide which affiliate location assets are eligible for serving.

| Enums ||
|---|---|
| `AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED` | Affiliate location matching type is not specified or is unknown in this version. |
| `SELECT_ALL` | All available affiliate location assets are eligible for serving. |
| `SELECTED_CHAINS` | The selected affiliate location assets can serve. |
| `DISABLED` | No affiliate location assets can serve. |

### AffiliateLocationMatchingFunction

The matching function for an affiliate location asset filter.

| JSON representation |
|---|
| ``` { "chains": [ { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationChain`) } ] } ``` |

| Fields ||
|---|---|
| `chains[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationChain`)`` Optional. The selected affiliate location chain IDs. This field is required if `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations#YoutubeAssetAssociation.AffiliateLocationAssetFilter.FIELDS.affiliate_location_matching_type` is `SELECTED_CHAINS`. |

### AffiliateLocationChain

A chain of affiliate locations.

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

| Fields ||
|---|---|
| `chainId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. ID of the affiliate location chain. |

### SitelinkAsset

A sitelink asset.

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

| Fields ||
|---|---|
| `assetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. ID of the sitelink asset. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations/create` | Creates a new association between the identified resource and a YouTube asset. |
| ### `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations/delete` | Deletes an existing association between the identified resource and a YouTube asset. |
| ### `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations/list` | Lists the YouTube asset associations linked to the given resource. |