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 [Google 商品类别] 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)

网页条件区分大小写，在进行过滤时，系统会用 AND 连接这些条件。所有条件应属于同一类型。示例 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 和 Label2，分别包含 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)

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