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 素材资源集中的元素来自于哪个同步级营业地点素材资源 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 中存在条目，则只有过滤条件指定的商家信息才有资格同步到素材资源。如果 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

用于封装多个 Google 地图位置信息同步数据的封装容器

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 过滤连锁店营业地点。只有属于指定连锁店的营业地点才会包含在素材资源集中。