2022 年 3 月 3 日

不定期更改。

市场营销 API

商品系列

目录搜索筛选条件变更

自 2022 年 3 月 3 日起,为便于在目录中创建商品系列,我们已更改特定筛选条件的运作方式。在创建商品系列时,这些变更会影响该系列中所纳入的具体商品。

时间线
字段和运算符的运作方式将在 90 天内发生改变。如果您在 2022 年 6 月 1 日后,为目录中的任意商品系列使用受影响的筛选条件,则相应系列中的商品可能会发生改变。具体表现为使用相应商品系列的广告或店铺中会显示不同的商品。此外,使用筛选条件的任何请求都可能返回一组不同的商品。

如需了解商品系列筛选条件的更多信息,请参阅此处

发生变更的运算符

运算符变更

contains / not_contains

您的查询现在必须与整个词相符,而不仅仅是词语的一部分。例如,name: {"contains": "red car"} 将返回所有包含这两个词的商品,如“red car”(红色汽车)和“red fast car”(红色跑车),而不会返回“red carpet”(红地毯)。


使用连字符的词将被视为由几个单独的词组成。例如,如果查询 name: {"contains": "shirt"},系统会同时匹配出“shirt”(衬衫)和“T-shirt”(T 恤)。


查询中的每个词都必须出现在您要匹配的字段中,但无需连续出现。例如,如果查询 name: {"contains": "jeans blue"},“blue cropped jeans”(蓝色七分或九分牛仔裤)将匹配出来;若只有“jeans”(牛仔裤)或“blue”(蓝色),则不会匹配出来。

lt

此筛选条件选项不再适用于 custom_label 字段。

lte

此筛选条件选项不再适用于 custom_label 字段

gt

此筛选条件选项不再适用于 custom_label 字段

gte

此筛选条件选项不再适用于 custom_label 字段

starts_with

此筛选条件选项目前仅适用于商品类别字段。对于其他字段,您应使用 contains 筛选条件。


发生变更的字段

字段描述

custom_label_0

商品、酒店、目的地、汽车或房源的自定义标签值。


此值被视为字符串。此字段无法使用数值运算符(gtgteltlte)。请转为使用支持整数的 custom_number_0 field 字段。

custom_label_1

商品、酒店、目的地、汽车或房源的自定义标签值。


此值被视为字符串。此字段无法使用数值运算符(gtgteltlte)。请转为使用支持整数的 custom_number_1 字段。

custom_label_2

商品、酒店、目的地、汽车或房源的自定义标签值。


此值被视为字符串。此字段无法使用数值运算符(gtgteltlte)。请转为使用支持整数的 custom_number_2 字段。

custom_label_3

商品、酒店、目的地、汽车或房源的自定义标签值。


此值被视为字符串。此字段无法使用数值运算符(gtgteltlte)。请转为使用支持整数的 custom_number_3 字段。

custom_label_4

商品、酒店、目的地、汽车或房源的自定义标签值。


此值被视为字符串。此字段无法使用数值运算符(gtgteltlte)。请转为使用支持整数的 custom_number_4 字段。

custom_number_0

商品、酒店、目的地、汽车或房源的自定义整数值。

custom_number_1

商品、酒店、目的地、汽车或房源的自定义整数值。

custom_number_2

商品、酒店、目的地、汽车或房源的自定义整数值。

custom_number_3

商品、酒店、目的地、汽车或房源的自定义整数值。

custom_number_4

商品、酒店、目的地、汽车或房源的自定义整数值。


基于偏移量的分页

现已将 GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=false 端点限制为 2000 个结果。

变更内容

目前,我们未对偏移量 + 限制大小施加任何限制。即日起,若 bulk_pagination = false,偏移量 + 限制大小将不能大于 2000。例如:

  • 若偏移量 = 1000,限制 = 1500,则将无法运作,因为偏移量 + 限制 = 2500
  • 若偏移量 = 100,限制 = 1500,则可正常运作,因为偏移量 + 限制 = 1600

若要在不受限的情况下对目录进行分页,则应使用 bulk_pagination = true