REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

资源：YoutubeAssetAssociation

资源与 YouTube 资产之间的关联。

JSON 表示法 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
字段
name

string

标识符。关联的资源名称。

对于订单项级关联：名称模式为 advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}。

对于广告组级联接，名称模式为 advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}。

对于 YOUTUBE_ASSET_TYPE_LOCATION 和 YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION 关联：youtubeAssetAssociationId 是所关联的素材资源集的 ID；如果 locationMatchingType 或 affiliateLocationMatchingType 为 DISABLED，则为 0。

对于 YOUTUBE_ASSET_TYPE_SITELINK 关联：youtubeAssetAssociationId 是所关联的站内链接素材资源的 ID。
youtubeAssetType

enum (YoutubeAssetType)

必需。与资源关联的 YouTube 资产的类型。
linkedYoutubeAsset

object (LinkedYouTubeAsset)

必需。与资源关联的 YouTube 资产。

YoutubeAssetType

可能的 YouTube 资源类型。

这些素材资源会在广告投放期间与广告一同展示，提供更多信息。

枚举
YOUTUBE_ASSET_TYPE_UNSPECIFIED 此版本中未指定 YouTube 资产类型，或资产类型未知。
YOUTUBE_ASSET_TYPE_LOCATION 地址素材资源。
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION 关联商户地址素材资源。

LinkedYouTubeAsset

与 YoutubeAssetAssociation 中的资源相关联的 YouTube 资产。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
字段
YouTube 资产。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
locationAssetFilter

object (LocationAssetFilter)

地址素材资源过滤条件。

只有当 youtubeAssetType 为 YOUTUBE_ASSET_TYPE_LOCATION 时才能设置此字段。
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

关联商户地址素材资源过滤条件。

只有当 youtubeAssetType 为 YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION 时才能设置此字段。
互斥字段的结束。

LocationAssetFilter

与符合投放条件的地址素材资源匹配的素材资源过滤条件。

JSON 表示法 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
字段
locationMatchingType

enum (LocationMatchingType)

必需。相应地址素材资源过滤条件的匹配类型。
assetSetId

string (int64 format)

仅限输出。与符合投放条件的营业地点素材资源相匹配的素材资源集的 ID。
locationMatchingFunction

object (LocationMatchingFunction)

可选。用于确定地址素材资源过滤条件如何与地址素材资源匹配的匹配函数。

此字段为必填字段，只能在 locationMatchingType 为 FILTER 或 SELECTED_ASSETS 时进行设置。

LocationMatchingType

决定哪些位置信息素材资源符合展示条件的可能匹配类型。

枚举
LOCATION_MATCHING_TYPE_UNSPECIFIED 此版本中未指定位置匹配类型，或位置匹配类型未知。
SELECT_ALL 所有可用的地址素材资源均可投放。
FILTER 与所提供的商家名称和/或标签过滤条件匹配的营业地点素材资源可以投放。
SELECTED_ASSETS 只有所选的营业地点素材资源可以投放。
DISABLED 无法投放任何地址素材资源。

LocationMatchingFunction

地址素材资源过滤器的匹配函数。

JSON 表示法 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
字段
labels[]

string

可选。要匹配的标签。

标签以逻辑“或”运算组合在一起。

此字段为可选字段，只有在 locationMatchingType 为 FILTER 时才能设置。
locationAssetIds[]

string (int64 format)

可选。所选地址素材资源的 ID。

如果 locationMatchingType 为 SELECTED_ASSETS，则此字段为必填字段。
business

string

可选。要匹配的商家名称。

此字段为可选字段，只有在 locationMatchingType 为 FILTER 时才能设置。

AffiliateLocationAssetFilter

一种素材资源过滤条件，用于匹配符合投放条件的关联商户地址素材资源。

JSON 表示法 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
字段
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

必需。相应关联商户地址素材资源过滤条件的匹配类型。
assetSetId

string (int64 format)

仅限输出。与符合投放条件的关联商户地址素材资源相匹配的素材资源集的 ID。
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

可选。用于确定关联商户地址素材资源过滤器如何与关联商户地址素材资源匹配的匹配函数。

此字段为必填字段，只能在 affiliateLocationMatchingType 为 SELECTED_CHAINS 时设置。

AffiliateLocationMatchingType

决定哪些关联商户地址素材资源符合展示条件的可能匹配类型。

枚举
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED 此版本中未指定关联商户地址匹配类型，或关联商户地址匹配类型未知。
SELECT_ALL 所有可用的关联商户地址素材资源均可投放。
SELECTED_CHAINS 所选的关联商户地址素材资源可以投放。
DISABLED 无法投放任何关联商户地址素材资源。

AffiliateLocationMatchingFunction

关联商户地址素材资源过滤器的匹配函数。

JSON 表示法 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
字段
chains[]

object (AffiliateLocationChain)

可选。所选关联商户连锁店 ID。

如果 affiliateLocationMatchingType 为 SELECTED_CHAINS，则此字段为必填字段。

AffiliateLocationChain

关联商户地址的连锁店。

JSON 表示法 
{
  "chainId": string
}
字段
chainId

string (int64 format)

必需。关联商户连锁店的 ID。

SitelinkAsset

站内链接素材资源。

JSON 表示法 
{
  "assetId": string
}
字段
assetId

string (int64 format)

必需。站内链接素材资源的 ID。

方法

create

 在已识别的资源与 YouTube 资产之间创建新的关联。

delete

 删除指定资源与 YouTube 资产之间的现有关联。

list

 列出与指定资源相关联的 YouTube 资产关联。