1. 淘宝没有schema接口,发布较原始,具体依赖就是类目属性值;
2. 发布字段枚举值可从类目属性值选,自定义的可输入;
3. 发布较宽松,字段大部分可选。
说明:淘宝的类目和品牌授权一般无限制,均可以发布商品,但有一些准入类目,需要卖家提供相关资质才可发布商品
管控类目:食品和酒类,书籍,保健品,类目,农药,医疗等类目需要资质才能发布,否则发失败。
taobao.itemcats.authorize.get(授权类目和品牌)
taobao.itemcats.get(可供发布的类目)
taobao.itemprops.get( 获取标准商品类目属性 )
taobao.itempropvalues.get( 获取标准类目属性值 )
入参: parent_cid=0;
出参:所有的可供发布的一级类目;
叶子类目获取:再次循环调用此接口,入参 parent_cid= 选择一级类目id,获得下一级类目id,直至获取叶子类目;
注意:商品需要挂靠在叶子类目发布。
入参:cid=1512(手机类目) 其他选填;
出参:所有的一级类目属性项和属性值;
入参:cid=1512;fields=cid,pid,prop_name,vid,name,name_alias,status,sort_order; pvs=139248429 (cpu 品牌);
出参:单个pid的values;
说明:区别于上一个api,这个是可自定义获取单个的propvalues,比上一个更灵活,不过还是建议全量更新最新的类目属性值。
1)关键属性 (品牌,型号);
2)商品属性 (一些标准属性);
3)绑定属性 (跟spu相关,淘宝也有产品类);
4)销售属性 (跟sku相关,影响sku的拼接);
发布说明:(搬过来的)
此接口用于新增一个商品;
商品所属的卖家是当前会话的用户;
商品的属性和sku的属性有包含的关系,商品的价格要位于sku的价格区间之中(例如,sku价格有5元、10元两种,那么商品的价格就需要大于等于5元,小于等于10元,否则新增商品会失败);
商品的类目和商品的价格、sku的价格都有一定的相关性(具体的关系要通过类目属性查询接口获得);
商品的运费承担方式和邮费设置有相关性,卖家承担运费不用设置邮费,买家承担运费需要设置邮费?
当关键属性值选择了“其他”的时候,需要输入input_pids和input_str商品才能添加成功。
必填项
首先里面所有必填的项,都是用 true 来标识的;
还有不同类目的商品,可能会有不同的必填项,比如你是食品类目,那么关于食品(food_security)的一些字段则是必须填的;还有本地生活(locality_life)拍卖(paimai_info)等一些字段。
"location.state":"浙江", "location.city":"杭州", "num":"999", "price":"999", "type":"fixed", "stuff_status":"new", "title":"测试商品请不要拍", "desc":"这是一个好商品", "cid":"50000671",
props
input_pids,input_str
input_custom_cpv
sku_properties
① 普通属性值枚举
拼接步骤:
写入props字段, pid:vid 填入,pid vid 来自类目属性值获取的结果
② 普通自定义输入属性值
拼接步骤:
写入input_pids,input_str ,不写入props。
③ 关键属性子属性自定义输入属性值
拼接步骤 同自定义输入属性值 注意:当关键属性值选择了“其他”的时候,需要输入input_pids和input_str商品才能添加成功。 备注: 用户自行输入的子属性名和属性值,结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如:“耐克;耐克系列;科比系列;科比系列;2K5,Nike乔丹鞋;乔丹系列;乔丹鞋系列;乔丹鞋系列;json5”,多个自定义属性用','分割,input_str需要与input_pids一一对应,注:通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过3999字节。此处不可以使用“其他”、“其它”和“其她”这三个词。
① 枚举值的销售属性
拼接步骤:
a. 写入props;
b. 写入sku_properties。
② 自定义的销售属性
拼接步骤:
需要写入input_custom_cpv,写入props,写入sku_properties。
③ 自定义的销售属性项、自定义销售属性值
拼接步骤:
自定义销售属性项不写入props,只写入sku_properties,并且自定义属性项加一个$进行标识。这种入参需要类目支持自定义属性项,如果类目不支持,入参会报错。
如:类目 50008779 拼接的sku_properties如下
5569827:55481260;1627207:130164;$双色:33;$双:33,5569827:55481260;1627207:130164;$双色:22;$双:3。
首先确定销售属性个数和销售属性值个数。
如颜色(红色,蓝色);尺码(S,M,L) 三个;那么sku则是 2*3=6个。
sku字段需填写
sku_properties
sku_quantities
sku_prices
sku_outer_ids
sku_barcode
涉及API
taobao.picture.upload(单张图片上传到图片空间)
taobao.item.img.upload(商品图片上传)
taobao.item.propimg.upload(商品属性图片上传)
使用taobao.item.add 接口操作。
说明:可传图文件字节 image,也可传图片链接 pic_path ,两个都传,优先使用pic_path。
涉及API
参考链接:https://open.taobao.com/api.htm?docId=148&docType=2;
注意:后台建好自己的运费模板。
涉及字段:postage_id(运费模板id)。
示例:
商品:含有颜色和尺码的衣服;
类目:女装/女士精品(16) >> T恤(50000671);
叶子类目:50000671。
json 格式的拼接好的商品字段
//宝贝省份 "location.state":"浙江", //宝贝城市 "location.city":"杭州", //宝贝数量 "num":"999", //商品价格 "price":"33", //一口价 "type":"fixed", //全新 "stuff_status":"new", //标题 "title":"测试商品请不要拍", //商品pc描述 "desc":"这是一个好商品", //类目 "cid":"50000671", //属性填写 "props":"20021:105255;13328588:145656297;20509:-1001;20509:28316;20509:28315;20509:28314;1627207:-1001;1627207:28321", //颜色尺码的自定义销售属性 "input_custom_cpv":"1627207:-1001:其他颜色;20509:-1001:其他尺码", //sku 的属性拼接 "sku_properties":"1627207:28321;20509:28314,1627207:28321;20509:28315,1627207:28321;20509:28316,1627207:28321;20509:-1001,1627207:-1001;20509:28314,1627207:-1001;20509:28315,1627207:-1001;20509:28316,1627207:-1001;20509:-1001", //sku 数量 "sku_quantities":"22,22,22,22,22,22,22,22", //sku 价格 "sku_prices":"33.00,33.00,33.00,33.00,33.00,33.00,33.00,33.00", //外部id "sku_outer_ids":"0,0,0,0,0,0,0,0", //条形码可以写0 "sku_barcode":"0,0,0,0,0,0,0,0", //货号属性id "input_pids":"13021751", //货号自定义属性值 "input_str":"333", //运费id,选择自己的运费id "postage_id":"23333333", //商品主图,更换为自己的图片链接 "pic_path":"i1/439948475/TB23q9Sr8smBKNjSZFFXXcT9VXa_!!439948475.jpg",
调用接口 taobao.item.add
done,恭喜你,成功发布一个测试商品(包含自定义属性,sku拼接等)。
涉及API
编辑的话,所有的属性均可编辑,入参需要传 num_iid。
1)商品和sku价格编辑可使用taobao.item.price.update/taobao.item.sku.price.update;
2)商品库存同步taobao.item.quantity.update/taobao.skus.quantity.update (仅限前端商品使用,绑定后端库存或者分销的,请使用其他调用)。