AssetSet

表示一系列资产的资产集。使用 AssetSetAsset 将资产与资产集相关联。

JSON 表示法 
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
字段
id

string (int64 format)

仅限输出。素材资源集的 ID。
resourceName

string

不可变。资产集的资源名称。素材资源组资源名称采用以下格式：

customers/{customerId}/assetSets/{asset_set_id}
name

string

必需。素材资源集的名称。必需。其长度下限为 1，上限为 128。
type

enum (AssetSetType)

必需。不可变。素材资源集的类型。必填。
status

enum (AssetSetStatus)

仅限输出。素材资源集的状态。只读。
merchantCenterFeed

object (MerchantCenterFeed)

Google Merchant Center 中的商家 ID 和 Feed 标签。
locationGroupParentAssetSetId

string (int64 format)

不可变。此素材资源集中元素的来源素材资源集的父素材资源集 ID。例如：同步级别 location AssetSet ID，其中 LocationGroup AssetSet 中的元素来源。此字段是必填字段，仅适用于营业地点组类型的 AssetSet。
hotelPropertyData

object (HotelPropertyData)

仅限输出。适用于关联了 Hotel Center 账号的指定旅行目标的效果最大化广告系列。只读。
联合字段 asset_set_source。每种素材资源集类型特有的素材资源组数据。并非所有类型都有特定数据。asset_set_source 只能是下列其中一项：
locationSet

object (LocationSet)

地址素材资源集数据。此设置将用于同步级别的位置设置。仅当 AssetSet 的类型为 LOCATION_SYNC 时才能设置。
businessProfileLocationGroup

object (BusinessProfileLocationGroup)

商家资料营业地点组素材资源集数据。
chainLocationGroup

object (ChainLocationGroup)

表示连锁店动态营业地点组的相关信息。仅在同步级别的 AssetSet 类型为 LOCATION_SYNC 且同步源为链型时适用。

AssetSetStatus

素材资源集的可能状态。

枚举
UNSPECIFIED 状态尚未指定。
UNKNOWN 接收的值在此版本中未知。这是一个仅用于响应的值。
ENABLED 此素材资源集已启用。
REMOVED 系统会移除此素材资源集。

MerchantCenterFeed

Google Merchant Center 中的商家 ID 和 Feed 标签。

JSON 表示法 
{
  "merchantId": string,
  "feedLabel": string
}
字段
merchantId

string (int64 format)

必需。Google Merchant Center 中的商家 ID
feedLabel

string

可选。Google Merchant Center 中的 Feed 标签。

HotelPropertyData

适用于关联了 Hotel Center 账号的指定旅行目标的效果最大化广告系列。只读。

JSON 表示法 
{
  "hotelCenterId": string,
  "partnerName": string
}
字段
hotelCenterId

string (int64 format)

仅限输出。合作伙伴的 Hotel Center ID。
partnerName

string

仅限输出。酒店合作伙伴的名称。

LocationSet

与位置设置相关的数据。需要指定“Google 商家资料”（以前称为“Google 我的商家”）数据、连锁店数据和地图位置数据之一。

JSON 表示法 
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
字段
locationOwnershipType

enum (LocationOwnershipType)

必需。不可变。营业地点所有权类型（自有营业地点或关联商户地址）。
联合字段 source。每个同步来源特有的位置数据。source 只能是下列其中一项：
businessProfileLocationSet

object (BusinessProfileLocationSet)

用于配置从 Google 商家资料营业地点填充的营业地点集的数据。
chainLocationSet

object (ChainSet)

用于为填充了指定连锁店的连锁店组配置营业地点的数据。
mapsLocationSet

object (MapsLocationSet)

仅在根据所选地图位置同步位置信息时设置

BusinessProfileLocationSet

用于配置从 Google 商家资料营业地点填充的营业地点集的数据。不同类型的过滤条件之间会进行 AND 运算（如果指定了）。

JSON 表示法 
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
字段
httpAuthorizationToken

string

必需。不可变。用于获取授权的 HTTP 授权令牌。
emailAddress

string

必需。不可变。Google 商家资料账号的电子邮件地址或 Google 商家资料账号管理员的电子邮件地址。
businessNameFilter

string

用于按商家名称过滤 Google 商家资料中的商家信息。如果设置了 businessNameFilter，则只有具有匹配的商家名称的商家信息才能被同步到素材资源中。
labelFilters[]

string

用于按标签过滤 Google 商家资料中的商家信息。如果 labelFilters 中存在条目，则只有设置了任何标签的商家信息才能同步到资产。如果 labelFilters 中没有条目，则所有商家信息都待同步。标签过滤条件以 OR 关系结合在一起。
listingIdFilters[]

string (int64 format)

用于根据商家信息 ID 过滤 Google 商家资料中的商家信息。如果 listingIdFilters 中存在条目，则只有过滤器指定的商品详情才需同步到 Asset。如果 listingIdFilters 中没有条目，则所有商家信息均应进行同步。房源 ID 过滤条件以 OR 关系结合在一起。
businessAccountId

string

不可变。要使用其营业地点的受管商家的账号 ID。如果未设置此字段，则使用用户可以访问的所有商家（由 emailAddress 指定）。

ChainSet

用于配置填充了指定连锁店的营业地点集的数据。

JSON 表示法 
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
字段
relationshipType

enum (ChainRelationshipType)

必需。不可变。指定的连锁店与此广告客户的关系类型。
chains[]

object (ChainFilter)

必需。链级过滤条件列表，所有过滤条件都以 OR 关系结合在一起。

ChainRelationshipType

可能的关系类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AUTO_DEALERS 汽车经销商关系。
GENERAL_RETAILERS 一般零售商关系。

ChainFilter

Feed 项集中一个针对营业地点的连锁店级过滤条件。所有字段的过滤逻辑均为 AND 关系。

JSON 表示法 
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
字段
chainId

string (int64 format)

必需。用于按连锁店 ID 过滤连锁店营业地点。只有属于指定连锁店的连锁营业地点才会出现在素材资源集中。
locationAttributes[]

string

用于按营业地点属性过滤连锁营业地点。只有属于所有指定属性的连锁营业地点才会出现在素材资源集中。如果此字段为空，则表示没有对此字段进行过滤。

MapsLocationSet

多地图位置同步数据的封装容器

JSON 表示法 
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
字段
mapsLocations[]

object (MapsLocationInfo)

必需。用户手动同步的地图位置信息列表。

MapsLocationInfo

地点 ID 的封装容器

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

string

Google 地图位置的地点 ID。

BusinessProfileLocationGroup

商家资料动态营业地点组的相关信息。仅在同步级别的 AssetSet 类型为 LOCATION_SYNC 且同步来源为商家资料时适用。

JSON 表示法 
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
字段
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

过滤出动态商家资料营业地点集。

DynamicBusinessProfileLocationGroupFilter

表示素材资源集中商家资料营业地点的过滤条件。如果提供多个过滤条件，这些过滤条件将以 AND 关系结合在一起。

JSON 表示法 
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
字段
labelFilters[]

string

用于按标签过滤商家资料营业地点。只有带有上述任一标签的营业地点才会出现在素材资源集中。标签过滤条件以 OR 关系结合在一起。
listingIdFilters[]

string (int64 format)

用于根据商家信息 ID 过滤商家资料营业地点。
businessNameFilter

object (BusinessProfileBusinessNameFilter)

用于按商家名称过滤商家资料营业地点。

BusinessProfileBusinessNameFilter

商家资料营业地点组商家名称过滤条件。

JSON 表示法 
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
字段
businessName

string

用于过滤的商家名称字符串。
filterType

enum (LocationStringFilterType)

使用 businessName 进行过滤时要使用的字符串匹配的类型。

LocationStringFilterType

位置字符串过滤条件的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
EXACT 过滤条件将使用完全匹配的字符串匹配。

ChainLocationGroup

表示连锁店动态营业地点组的相关信息。仅在同步级别的 AssetSet 类型为 LOCATION_SYNC 且同步源为链型时适用。

JSON 表示法 
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
字段
dynamicChainLocationGroupFilters[]

object (ChainFilter)

用于按连锁店 ID 过滤连锁店营业地点。只有属于指定连锁店的营业地点才会出现在此素材资源组中。