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 资产关联。