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 表示法 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
字段
联合字段 youtube_asset。YouTube 资产。youtube_asset 只能是下列其中一项：
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

可选。要匹配的标签。

标签会进行逻辑 OR 运算。

此字段是可选字段，只有当 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 资产关联。