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。例如：LocationGroup AssetSet 中元素的来源同步级位置 AssetSet ID。此字段是必填字段，且仅适用于营业地点组类型的 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 中存在条目，则只有过滤器指定的列表适合同步到 Assets。如果 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 项集中营业地点的 1 个连锁店级过滤条件。所有字段的过滤逻辑均为 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 过滤连锁店营业地点。只有属于指定连锁店的营业地点才会出现在素材资源集中。