异步更新智能专辑规则

PATCH 
/openapi/2026-01/collections/:id/smart-rule/async

异步更新智能专辑的匹配规则。接口立即返回异步任务 ID，调用方使用 GetCollectionAsyncTask 轮询结果。

请求

Path参数

id string必填

智能专辑 ID

application/json

请求体

请求体必填

match_rules object
智能专辑的匹配规则
disjunctiveboolean
规则模块之间的逻辑关系：
• true：满足任一规则模块即可（OR）
• false：所有规则模块都必须满足（AND，默认）
rule_modules object[]
规则模块列表
Array [
disjunctiveboolean
模块内规则之间的逻辑关系：
• true：满足任一规则即可（OR）
• false：所有规则都必须满足（AND，默认）
rules object[]
模块内的规则列表
Array [
columnstring
规则匹配的目标字段。可选值：
• title：商品标题
• product_status：商品状态
• tags：商品标签
• vendor：供应商 / 品牌
• variant_price：SKU 价格
• variant_weight：SKU 重量
• inventory_quantity：库存数量
• product_note：商品备注
• sales：销售量
• real_sales：实际销售量
• views：浏览量
• add_to_cart_count：加购次数
• created_at：商品创建时间
• spu：SPU 标识符
• spus_match：SPU 匹配状态
• published_at：发布时间
• category_id：类目 ID
• brand：品牌
relationstring
用于匹配的比较运算符。可选值：
• equals：等于
• not_equals：不等于
• starts_with：以...开头
• ends_with：以...结尾
• contains：包含
• not_contains：不包含
• greater_than：大于
• less_than：小于
• top：前 N 个结果（通常用于可排序字段）
conditionstring
规则的条件值
• 文本字段：普通字符串。
• 数值字段：可转换为数字的字符串。
• 时间字段：时间戳或约定的时间格式。
• top 运算符：代表 N 的值。
]
]

示例

{
  "match_rules": {
    "disjunctive": true,
    "rule_modules": [
      {
        "disjunctive": true,
        "rules": [
          {
            "column": "string",
            "relation": "string",
            "condition": "string"
          }
        ]
      }
    ]
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

async_task_idstring

异步任务 ID，使用 GetCollectionAsyncTask 接口轮询任务结果

collection object

专辑

idstring

专辑 ID

titlestring

专辑名称

descriptionstring

专辑描述

handlestring

专辑 handle（URL 友好的唯一别名）

smartboolean

是否为智能专辑（满足条件的商品自动加入）

image object

专辑封面

srcstring

图片来源 URL

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

altstring

图片替代文本

seo_titlestring

专辑的 SEO 标题

seo_keywordsstring[]

SEO 关键词列表

seo_descriptionstring

专辑的 SEO 描述

sort_orderstring

专辑内商品的排序规则（取值见创建专辑接口）

created_atstring

专辑创建时间（ISO-8601 格式）

updated_atstring

专辑最后更新时间（ISO-8601 格式）

match_rules object

智能集合匹配规则

disjunctiveboolean

条件是否为析取关系（OR）

rule_modules object[]

规则模块列表

Array [

disjunctiveboolean

条件是否为析取关系（OR）

rules object[]

此模块中的规则列表

Array [

columnstring

列

relationstring

关联关系

conditionstring

条件

]

]

tagsstring[]

集合标签列表

product_countint64

集合中的商品数量

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "async_task_id": "string",
    "collection": {
      "id": "string",
      "title": "string",
      "description": "string",
      "handle": "string",
      "smart": true,
      "image": {
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string"
      },
      "seo_title": "string",
      "seo_keywords": [
        "string"
      ],
      "seo_description": "string",
      "sort_order": "string",
      "created_at": "string",
      "updated_at": "string",
      "match_rules": {
        "disjunctive": true,
        "rule_modules": [
          {
            "disjunctive": true,
            "rules": [
              {
                "column": "string",
                "relation": "string",
                "condition": "string"
              }
            ]
          }
        ]
      },
      "tags": [
        "string"
      ],
      "product_count": 0
    }
  }
}