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/{assetGroupId}~{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)

locality 的值。

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 中的网址和来自广告客户网域的网址。一个素材资源组中可以有多个具有此维度的根节点，并且这些根节点的条件会被视作“或”运算符。

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 作为自定义标签条件，将匹配 网址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)

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