taobao.sellercats.list.add (添加卖家自定义类目)

此API添加卖家店铺内自定义类目 父类目parent_cid值等于0:表示此类目为店铺下的一级类目,值不等于0:表示此类目有父类目 注:因为缓存的关系,添加的新类目需8个小时后才可以在淘宝页面上正常显示,但是不影响在该类目下商品发布

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
name String 必须 店铺一级类目 卖家自定义类目名称。不超过20个字符
pict_url String 可选 http://host/image_path 链接图片URL地址。(绝对地址,格式:http://host/image_path)
parent_cid Number 可选 12345678 父类目编号,如果类目为店铺下的一级类目:值等于0,如果类目为子类目,调用获取taobao.sellercats.list.get父类目编号
sort_order Number 可选 6 该类目在页面上的排序位置,取值范围:大于零的整数

响应参数

名称 类型 示例值 描述
seller_cat SellerCat 返回seller_cat数据结构中的:cid,created
  • └ cid
  • Number
  • 12345
  • 卖家自定义类目编号
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 创建时间。格式:yyyy-MM-dd HH:mm:ss

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SellercatsListAddRequest req = new SellercatsListAddRequest();
req.setName("店铺一级类目");
req.setPictUrl("http://host/image_path");
req.setParentCid(12345678L);
req.setSortOrder(6L);
SellercatsListAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<sellercats_list_add_response>
    <seller_cat>
        <cid>12345</cid>
        <created>2000-01-01 00:00:00</created>
    </seller_cat>
</sellercats_list_add_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.shop-service-error:SHOP_CATEGORY_ORDER_ERROR 类目在页面上的排序出错 用taobao.sellercats.list.get 获取最大的类目排序,然后在此基础上添加类目,不能添加类目排序超过(最大排序+1)的类目
isv.shop-service-error:SHOP_CAT_IS_EXIST 类目已经存在 类目名称不要重复

API工具

如何获得此API

FAQ

返回
顶部