- JSON 表示法
- AssetSetStatus
- MerchantCenterFeed
- HotelPropertyData
- LocationSet
- BusinessProfileLocationSet
- ChainSet
- ChainRelationshipType
- ChainFilter
- MapsLocationSet
- MapsLocationInfo
- BusinessProfileLocationGroup
- DynamicBusinessProfileLocationGroupFilter
- BusinessProfileBusinessNameFilter
- LocationStringFilterType
- ChainLocationGroup
表示一系列素材资源的素材资源集。使用 AssetSetAsset 将资产与资产集相关联。
JSON 表示法 |
---|
{ "id": string, "resourceName": string, "name": string, "type": enum ( |
字段 | |
---|---|
id |
仅供输出。素材资源集的 ID。 |
resourceName |
不可变。资产集的资源名称。资源集资源名称采用以下格式:
|
name |
必需。素材资源组的名称。必需。长度下限必须为 1,长度上限为 128。 |
type |
必需。不可变。素材资源集的类型。必填。 |
status |
仅供输出。素材资源集的状态。只读。 |
merchantCenterFeed |
Google Merchant Center 中的商家 ID 和 Feed 标签。 |
locationGroupParentAssetSetId |
不可变。此资产集的元素来自的资产集的父资产组 ID。例如:同步级别的位置 AssetSet ID(LocationGroup AssetSet 中的元素来自此处)。此字段是必填字段,且仅适用于营业地点组类型的 AssetSet。 |
hotelPropertyData |
仅供输出。适用于已关联 Hotel Center 的指定旅行目标的效果最大化广告系列。只读。 |
联合字段 asset_set_source 。每种素材资源组类型特有的素材资源集数据。并非所有类型都有特定的数据。asset_set_source 只能是下列其中一项: |
|
locationSet |
地址素材资源集数据。这将用于设置同步级别的位置。仅当 AssetSet 的类型为 LOCATION_SYNC 时才能设置此字段。 |
businessProfileLocationGroup |
商家资料营业地点组素材资源组数据。 |
chainLocationGroup |
表示连锁店动态营业地点组的相关信息。仅在同步级别 AssetSet 的类型为 LOCATION_SYNC 且同步来源为链时适用。 |
AssetSetStatus
素材资源组的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定状态。 |
UNKNOWN |
此版本中未知接收的值。这是一个仅用于响应的值。 |
ENABLED |
此素材资源组已启用。 |
REMOVED |
该素材资源集会被移除。 |
MerchantCenterFeed
Google Merchant Center 中的商家 ID 和 Feed 标签。
JSON 表示法 |
---|
{ "merchantId": string, "feedLabel": string } |
字段 | |
---|---|
merchantId |
必需。Google Merchant Center 中的商家 ID |
feedLabel |
可选。Google Merchant Center 中的 Feed 标签。 |
HotelPropertyData
适用于已关联 Hotel Center 的指定旅行目标的效果最大化广告系列。只读。
JSON 表示法 |
---|
{ "hotelCenterId": string, "partnerName": string } |
字段 | |
---|---|
hotelCenterId |
仅供输出。合作伙伴的 Hotel Center ID。 |
partnerName |
仅供输出。酒店合作伙伴的名称。 |
LocationSet
与位置设置相关的数据。您需要指定 Google 商家资料(以前称为“Google 我的商家”)数据、连锁店数据和地图位置数据之一。
JSON 表示法 |
---|
{ "locationOwnershipType": enum ( |
字段 | |
---|---|
locationOwnershipType |
必需。不可变。营业地点所有权类型(自有的营业地点或关联商户地址)。 |
联合字段 source 。每个同步来源特有的位置数据。source 只能是下列其中一项: |
|
businessProfileLocationSet |
用于配置营业地点集的数据,其中填充了从 Google 商家资料中的营业地点信息。 |
chainLocationSet |
用于配置连锁店集合中的营业地点的数据,其中填充了指定连锁店。 |
mapsLocationSet |
仅当根据所选的地图上的地点同步地点时,才需要设置 |
BusinessProfileLocationSet
用于配置营业地点集的数据,其中填充了从 Google 商家资料中的营业地点信息。不同类型的过滤条件会以 AND 关系组合在一起(如果已指定)。
JSON 表示法 |
---|
{ "httpAuthorizationToken": string, "emailAddress": string, "businessNameFilter": string, "labelFilters": [ string ], "listingIdFilters": [ string ], "businessAccountId": string } |
字段 | |
---|---|
httpAuthorizationToken |
必需。不可变。用于获得授权的 HTTP 授权令牌。 |
emailAddress |
必需。不可变。Google 商家资料账号的电子邮件地址或 Google 商家资料账号管理员的电子邮件地址。 |
businessNameFilter |
用于按商家名称过滤 Google 商家资料中的商家信息。如果设置了 businessNameFilter,则只有商家名称与匹配的商家信息才能同步到“素材资源”中。 |
labelFilters[] |
用于按标签过滤 Google 商家资料中的商家信息。如果 labelFilters 中存在条目,则只有设置了任何标签的商品信息可同步到 Assets 中。如果 labelFilters 中没有条目,则所有商家信息都待同步。标签过滤条件之间是 OR 关系。 |
listingIdFilters[] |
用于按商家信息 ID 过滤 Google 商家资料中的商家信息。如果 listingIdFilters 中存在条目,则只有过滤器指定的列表候选对象要同步到 Assets。如果 listingIdFilters 中不存在任何条目,则所有商家信息都待同步。房源 ID 过滤条件通过 OR 运算符连接在一起。 |
businessAccountId |
不可变。要使用其营业地点的受管商家的账号 ID。如果未设置此字段,则系统会使用用户可以访问的所有商家(通过 emailAddress 指定)。 |
ChainSet
用于配置填充了指定连锁店的营业地点集的数据。
JSON 表示法 |
---|
{ "relationshipType": enum ( |
字段 | |
---|---|
relationshipType |
必需。不可变。指定连锁店与此广告客户的关系类型。 |
chains[] |
必需。链级过滤条件列表,所有过滤条件均通过 OR 运算符连接在一起。 |
ChainRelationshipType
可能的关系类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
AUTO_DEALERS |
汽车经销商关系。 |
GENERAL_RETAILERS |
一般零售商关系。 |
ChainFilter
针对 Feed 项集中营业地点的 1 个连锁店级过滤条件。所有字段之间的过滤逻辑均为 AND。
JSON 表示法 |
---|
{ "chainId": string, "locationAttributes": [ string ] } |
字段 | |
---|---|
chainId |
必需。用于按连锁店 ID 过滤连锁店营业地点。素材资源集中仅包含属于指定连锁店的连锁营业地点。 |
locationAttributes[] |
用于按营业地点属性过滤连锁营业地点。素材资源集中仅包含属于所有指定属性的连锁营业地点。如果此字段为空,则表示不对此字段进行过滤。 |
MapsLocationSet
多个地图位置同步数据的封装容器
JSON 表示法 |
---|
{
"mapsLocations": [
{
object ( |
字段 | |
---|---|
mapsLocations[] |
必需。包含用户手动同步的地图位置信息的列表。 |
MapsLocationInfo
地点 ID 的封装容器
JSON 表示法 |
---|
{ "placeId": string } |
字段 | |
---|---|
placeId |
Google 地图营业地点的地点 ID。 |
BusinessProfileLocationGroup
商家资料动态营业地点组的相关信息。仅在同步级别 AssetSet 的类型为 LOCATION_SYNC 且同步来源为“商家资料”时适用。
JSON 表示法 |
---|
{
"dynamicBusinessProfileLocationGroupFilter": {
object ( |
字段 | |
---|---|
dynamicBusinessProfileLocationGroupFilter |
针对动态商家资料营业地点集进行过滤。 |
DynamicBusinessProfileLocationGroupFilter
表示针对素材资源组中的商家资料营业地点进行过滤。如果提供了多个过滤条件,这些过滤条件将通过 AND 运算符连接在一起。
JSON 表示法 |
---|
{
"labelFilters": [
string
],
"listingIdFilters": [
string
],
"businessNameFilter": {
object ( |
字段 | |
---|---|
labelFilters[] |
用于根据标签过滤商家资料营业地点。只有具有所列标签中的任意一个营业地点才会出现在素材资源组中。标签过滤条件之间是 OR 关系。 |
listingIdFilters[] |
用于根据商家信息 ID 过滤商家资料营业地点。 |
businessNameFilter |
用于按商家名称过滤商家资料营业地点。 |
BusinessProfileBusinessNameFilter
商家资料营业地点组商家名称过滤条件。
JSON 表示法 |
---|
{
"businessName": string,
"filterType": enum ( |
字段 | |
---|---|
businessName |
用于过滤的商家名称字符串。 |
filterType |
使用 businessName 进行过滤时要使用的字符串匹配类型。 |
LocationStringFilterType
可能的位置字符串过滤条件类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
EXACT |
过滤条件将使用完全匹配的字符串。 |
ChainLocationGroup
表示连锁店动态营业地点组的相关信息。仅在同步级别 AssetSet 的类型为 LOCATION_SYNC 且同步来源为链时适用。
JSON 表示法 |
---|
{
"dynamicChainLocationGroupFilters": [
{
object ( |
字段 | |
---|---|
dynamicChainLocationGroupFilters[] |
用于按连锁店 ID 过滤连锁店营业地点。只有属于指定连锁店的营业地点才会出现在素材资源组中。 |