简体中文

English

简体中文

English

显示模式

关于 系列 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

产品系列 是指商家将相关产品分组在一起形成的集合，通过将相关产品进行分组管理，帮助商家更好地展示和管理商品。Genstore 提供了一系列 RESTful 接口，支持产品系列的创建、管理、查询等操作，助力商家打造更好的商品浏览和购物体验。

核心功能

  • 基础操作：创建产品系列、更新产品系列信息、删除产品系列。
  • 信息查询：查询系列详情、查询系列列表、统计系列数量。
  • 管理产品系列中的商品：新增系列商品、移除系列商品、查询系列商品列表。

应用场景

  • 商品分类展示：商品运营团队可通过接口组织商品集合、配置展示规则、管理季节性陈列，打造富有吸引力的购物体验，提升品类表现。
  • 营销活动支持：营销团队可快速创建和更新主题集合、排期促销展示、协调多渠道商品上新，最大化活动效果和商品曝光。
  • 商品管理优化：商品管理员可高效维护多个集合、跨品类同步商品信息、批量更新集合规则，简化集合维护工作，降低运营成本。

接口

EVENT collections/create: 系列创建

EVENT collections/update: 系列更新

EVENT collections/delete: 系列删除

产品系列 对象 ​

产品系列业务域对象。

属性 ​

collectionobject
返回系列的详细信息。
- 收起属性
titlestring
产品系列标题。
bodyHtmlstring
产品系列描述，支持 HTML 格式。
collectionTypenumber
产品系列类型。枚举值：1 - 定制系列；2 - 智能系列。
imageobject
产品系列图片。
+ 展开属性
publishedboolean
是否发布到在线商店。
ruleSetobject
智能产品系列中将产品分配给系列的规则。
+ 展开属性
collectionIdnumber
产品系列唯一标识符。
countGoodsNumnumber
系列关联的产品数量。
collectsarray
系列关联产品唯一标识符列表。
bash
{
  "collection": {
    "collectionType": "1",
    "image": {
      "src": "https://cdn.shopify.com/s/files/1/0600/8317/5513/files/wax-special_150x.png?v=1716260624"
    },
    "ruleSet": {
      "appliedDisjunctively": "true",
      "rules": [
        {
          "condition": "["test"]",
          "column": "title",
          "relation": "equals"
        }
      ]
    },
    "bodyHtml": "<p>Test Description</p>",
    "published": "true",
    "title": "Collection Title",
    "collectionId": "102984300756584",
    "collects": "[102744899756584,102744899756583]",
    "countGoodsNum": "3"
  }
}

EVENT 系列创建 ​

系列创建产生事件

访问范围

需要以下任意访问权限: write_products read_products

消息

EVENT collections/create 

消息数据

collectionobject
返回系列的详细信息。
- 收起属性
titlestring
产品系列标题。
bodyHtmlstring
产品系列描述，支持HTML格式。
collectionTypenumber
产品系列类型。枚举值：1 - 定制系列；2 - 智能系列。
imageobject
产品系列图片。
+ 展开属性
publishedboolean
是否发布到在线。
ruleSetobject
智能产品系列中将产品分配给系列的规则。
+ 展开属性
collectionIdnumber
产品系列唯一标识符。
countGoodsNumnumber
系列关联的产品数量。
collectsarray
系列关联产品唯一标识符列表。
json
{
  "collection": {
    "collectionType": "1",
    "image": {
      "src": "https://cdn.shopify.com/s/files/1/0600/8317/5513/files/wax-special_150x.png?v=1716260624"
    },
    "ruleSet": {
      "appliedDisjunctively": "true",
      "rules": [
        {
          "condition": "[\"test\"]",
          "column": "title",
          "relation": "equals"
        }
      ]
    },
    "bodyHtml": "<p>Test Description</p>",
    "published": "true",
    "title": "Collection Title",
    "collectionId": "102984300756584",
    "collects": "[102744899756584,102744899756583]",
    "countGoodsNum": "3"
  }
}

EVENT 系列更新 ​

访问范围

需要以下任意访问权限: write_products read_products

消息

EVENT collections/update 

消息数据

collectionobject
返回系列的详细信息。
- 收起属性
titlestring
产品系列标题。
bodyHtmlstring
产品系列描述。支持 HTML 格式。
collectionTypenumber
产品系列类型。枚举值：1 - 定制系列；2 - 智能系列。
imageobject
产品系列图片。
+ 展开属性
publishedboolean
是否发布到在线商店。
ruleSetobject
智能产品系列中将产品分配给系列的规则。
+ 展开属性
collectionIdnumber
产品系列唯一标识符。
countGoodsNumnumber
系列关联的产品数量。
collectsarray
系列关联产品唯一标识符列表。
json
{
  "collection": {
    "collectionType": "1",
    "image": {
      "src": "https://cdn.shopify.com/s/files/1/0600/8317/5513/files/wax-special_150x.png?v=1716260624"
    },
    "ruleSet": {
      "appliedDisjunctively": "true",
      "rules": [
        {
          "condition": "[\"test\"]",
          "column": "title",
          "relation": "equals"
        }
      ]
    },
    "bodyHtml": "<p>Test Description</p>",
    "published": "true",
    "title": "Collection Title",
    "collectionId": "102984300756584",
    "collects": "[102744899756584,102744899756583]",
    "countGoodsNum": "3"
  }
}

EVENT 系列删除 ​

访问范围

需要以下任意访问权限: write_products read_products

消息

EVENT collections/delete 

消息数据

collectionIdstring
产品系列唯一标识符。
json
{
  "collectionId": "1234"
}