AssetGroupListingGroupFilter

AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤器树节点。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
字段
resourceName

string

不可变。素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下格式：

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

不可变。此素材资源组产品信息组过滤条件所属的素材资源组。
id

string (int64 format)

仅供输出。ListingGroupFilter 的 ID。
type

enum (ListingGroupFilterType)

不可变。产品信息组过滤条件节点的类型。
listingSource

enum (ListingGroupFilterListingSource)

不可变。按此产品信息组过滤条件过滤的商家信息来源。
caseValue

object (ListingGroupFilterDimension)

此产品信息组用于优化其父级的维度值。没有为根组定义。
parentListingGroupFilter

string

不可变。父级产品信息组细分的资源名称。对于根产品信息组过滤器节点，此字段为 null。
path

object (ListingGroupFilterDimensionPath)

仅供输出。定义此产品信息组过滤条件的维度的路径。

ListingGroupFilterType

产品信息组过滤条件的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SUBDIVISION 根据某些商品详情维度细分商品。
UNIT_INCLUDED 包含的产品信息组过滤条件叶节点。
UNIT_EXCLUDED 已排除的产品信息组过滤条件叶节点。

ListingGroupFilterListingSource

按产品信息组过滤节点过滤的商家信息来源。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SHOPPING 购物来源中的商品详情，例如 Google Merchant Center 中的商品。
WEBPAGE 来自网页来源的商家信息，例如来自页面 Feed 或广告客户网域的网址。

ListingGroupFilterDimension

素材资源组产品信息组过滤条件的产品信息维度。

JSON 表示法 
{

  // Union field dimension can be only one of the following:
  "productCategory": {
    object (ProductCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  },
  "webpage": {
    object (Webpage)
  }
  // End of list of possible types for union field dimension.
}
字段
联合字段 dimension。以下类型之一的维度始终显示。dimension 只能是下列其中一项：
productCategory

object (ProductCategory)

商品优惠的类别。
productBrand

object (ProductBrand)

商品优惠的品牌。
productChannel

object (ProductChannel)

商品优惠的适用地区。
productCondition

object (ProductCondition)

商品的使用情况。
productCustomAttribute

object (ProductCustomAttribute)

商品优惠的自定义属性。
productItemId

object (ProductItemId)

商品优惠的商品 ID。
productType

object (ProductType)

商品优惠的类型。
webpage

object (Webpage)

用于过滤页面 Feed 中的网址和广告客户网域的网址。

ProductCategory

属于特定级别的类别的一个元素。顶级类别位于级别 1，其子类别位于级别 2，以此类推。目前，我们最多支持 5 个级别。用户必须指定可以表明类别层级的维度类型。同一细分的所有案例都必须具有相同的维度类型（类别级别）。

JSON 表示法 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
字段
level

enum (ListingGroupFilterProductCategoryLevel)

表示分类中的类别级别。
categoryId

string (int64 format)

商品类别的 ID。

此 ID 相当于 google_product_category ID，如以下文章中所述：https://support.google.com/merchants/answer/6324436

ListingGroupFilterProductCategoryLevel

产品信息组过滤条件产品类别的级别。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEVEL1 级别 1。
LEVEL2 级别 2。
LEVEL3 级别 3。
LEVEL4 级别 4。
LEVEL5 级别 5。

ProductBrand

商品的品牌。

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

string

产品品牌的字符串值。

ProductChannel

商品优惠的适用地区。

JSON 表示法 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
字段
channel

enum (ListingGroupFilterProductChannel)

市行政区的值。

ListingGroupFilterProductChannel

描述商品优惠地点的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ONLINE 商品在线销售。
LOCAL 商品在本地商店出售。

ProductCondition

商品的使用情况。

JSON 表示法 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
字段
condition

enum (ListingGroupFilterProductCondition)

条件的值。

ListingGroupFilterProductCondition

用于描述商品使用情况的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NEW 商品使用情况为全新。
REFURBISHED 商品使用情况为翻新。
USED 系统会使用产品条件。

ProductCustomAttribute

商品优惠的自定义属性。

JSON 表示法 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
字段
index

enum (ListingGroupFilterCustomAttributeIndex)

表示自定义属性的索引。
value

string

商品自定义属性的字符串值。

ListingGroupFilterCustomAttributeIndex

客户属性的索引。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
INDEX0 第一个产品信息组过滤条件自定义属性。
INDEX1 第二个产品信息组过滤条件自定义属性。
INDEX2 第三个产品信息组过滤条件自定义属性。
INDEX3 第四个产品信息组过滤条件自定义属性。
INDEX4 第五个产品信息组过滤条件自定义属性。

ProductItemId

商品优惠的商品 ID。

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

string

ID 的值。

ProductType

商品优惠的类型。

JSON 表示法 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
字段
level

enum (ListingGroupFilterProductTypeLevel)

类型的级别。
value

string

类型的值。

ListingGroupFilterProductTypeLevel

描述商品类型级别的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEVEL1 级别 1。
LEVEL2 级别 2。
LEVEL3 级别 3。
LEVEL4 级别 4。
LEVEL5 级别 5。

网页

用于过滤页面 Feed 中的网址和广告客户网域的网址。一个素材资源组中可以有多个具有此维度的根节点，这些节点的条件采用 OR 运算符。

JSON 表示法 
{
  "conditions": [
    {
      object (WebpageCondition)
    }
  ]
}
字段
conditions[]

object (WebpageCondition)

网页条件区分大小写，在执行过滤评估时会将这些条件合并在一起。所有条件都应为同一类型。示例 1：如果网址 1 为 www.ads.google.com?ocid=1&euid=2，网址 2 为 www.ads.google.com?ocid=1，并且以“ocid”和“euid”作为 urlContains 条件，则匹配网址 1，但网址 2 不匹配。

示例 2 ：如果网址 1 包含 Label1、Label2，并且网址 2 包含 Label2、Label3，然后将 Label1 和 Label2 作为 customLabel 条件，则将匹配 网址1，但不匹配 网址2。如果 Label2 是唯一的 customLabel 条件，则 网址1 和 网址2 都将匹配。

WebpageCondition

网址过滤的匹配条件。

JSON 表示法 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
字段
联合字段 condition。用于过滤网址的条件。condition 只能是下列其中一项：
customLabel

string

过滤包含此自定义标签的页面 Feed 中的网址。要向广告系列添加自定义标签，请创建类型为 PAGE_Feed 的 AssetSet，并使用 CampaignAssetSet 将其关联到广告系列。
urlContains

string

过滤页面 Feed 中的网址以及广告客户网域中包含此字符串的网址。

ListingGroupFilterDimensionPath

用于定义产品信息组过滤器的维度的路径。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
字段
dimensions[]

object (ListingGroupFilterDimension)

仅供输出。维度从产品信息组过滤器层次结构（不包括根节点）到此产品信息组过滤器的完整路径。