1.淘宝没有schema接口,发布较原始,具体依赖就是类目属性值;
2.发布字段枚举值可从类目属性值选,自定义的可输入;
3.发布较宽松,字段大部分可选。
管控类目:食品和酒类,书籍,保健品,类目,农药,医疗等类目需要资质才能发布,否则发失败。
入参: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)商品属性(一些标准属性);
发布说明:(搬过来的)
此接口用于新增一个商品;
商品所属的卖家是当前会话的用户;
商品的属性和sku的属性有包含的关系,商品的价格要位于sku的价格区间之中(例如,sku价格有5元、10元两种,那么商品的价格就需要大于等于5元,小于等于10元,否则新增商品会失败);
当关键属性值选择了“其他”的时候,需要输入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填入,pidvid来自类目属性值获取的结果
②普通自定义输入属性值
写入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_quantities
sku_prices
sku_outer_ids
sku_barcode
涉及API
使用taobao.item.add接口操作。
说明:可传图文件字节image,也可传图片链接pic_path,两个都传,优先使用pic_path。
注意:后台建好自己的运费模板。
涉及字段:postage_id(运费模板id)。
示例:
商品:含有颜色和尺码的衣服;
类目:女装/女士精品(16)>>T恤(50000671);
叶子类目:50000671。
json格式的拼接好的商品字段
调用接口taobao.item.add
done,恭喜你,成功发布一个测试商品(包含自定义属性,sku拼接等)。
编辑的话,所有的属性均可编辑,入参需要传num_iid。
2)商品库存同步taobao.item.quantity.update/taobao.skus.quantity.update(仅限前端商品使用,绑定后端库存或者分销的,请使用其他调用)。