文档中心 > 商家经营工具-开发指引

淘宝商品发布编辑示例

更新时间:2024/07/31 访问次数:43739

一、淘宝现状


1. 淘宝没有schema接口,发布较原始,具体依赖就是类目属性值;

2. 发布字段枚举值可从类目属性值选,自定义的可输入;

3. 发布较宽松,字段大部分可选。


二、淘宝类目属性获取(规则获取)


说明:淘宝的类目和品牌授权一般无限制,均可以发布商品,但有一些准入类目,需要卖家提供相关资质才可发布商品

管控类目:食品和酒类,书籍,保健品,类目,农药,医疗等类目需要资质才能发布,否则发失败。


1. 涉及API

taobao.itemcats.authorize.get(授权类目和品牌)

taobao.itemcats.get(可供发布的类目)

taobao.itemprops.get( 获取标准商品类目属性 )

taobao.itempropvalues.get( 获取标准类目属性值 )


2. 可发类目获取

taobao.itemcats.get

入参: parent_cid=0;

出参:所有的可供发布的一级类目;

叶子类目获取:再次循环调用此接口,入参 parent_cid= 选择一级类目id,获得下一级类目id,直至获取叶子类目;

注意:商品需要挂靠在叶子类目发布。


3. 标准商品类目属性获取


taobao.itemprops.get

入参:cid=1512(手机类目) 其他选填;

出参:所有的一级类目属性项和属性值;


4. 获取标准类目属性值


taobao.itempropvalues.get

入参:cid=1512;fields=cid,pid,prop_name,vid,name,name_alias,status,sort_order; pvs=139248429 (cpu 品牌);

出参:单个pid的values;

说明:区别于上一个api,这个是可自定义获取单个的propvalues,比上一个更灵活,不过还是建议全量更新最新的类目属性值。


三、商品发布


1. 涉及API


taobao.item.add


2. 发布概述

商品的属性


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)等一些字段。


四、发布步骤

步骤1:必填字段准备–基本的信息字段值


"location.state":"浙江",
"location.city":"杭州",
"num":"999",
"price":"999",
"type":"fixed",
"stuff_status":"new",
"title":"测试商品请不要拍",
"desc":"这是一个好商品",
"cid":"50000671",


步骤2:属性值填写


1)需拼接字段

props

input_pids,input_str

input_custom_cpv

sku_properties


2)非销售属性拼接

① 普通属性值枚举

拼接步骤:

写入props字段, pid:vid 填入,pid vid 来自类目属性值获取的结果


② 普通自定义输入属性值

拼接步骤:

写入input_pids,input_str ,不写入props。

③ 关键属性子属性自定义输入属性值

拼接步骤 同自定义输入属性值
 注意:当关键属性值选择了“其他”的时候,需要输入input_pids和input_str商品才能添加成功。
备注:
用户自行输入的子属性名和属性值,结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如:“耐克;耐克系列;科比系列;科比系列;2K5,Nike乔丹鞋;乔丹系列;乔丹鞋系列;乔丹鞋系列;json5”,多个自定义属性用','分割,input_str需要与input_pids一一对应,注:通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过3999字节。此处不可以使用“其他”、“其它”和“其她”这三个词。


3)销售属性拼接


① 枚举值的销售属性

拼接步骤:

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。


4)SKU拼接

首先确定销售属性个数和销售属性值个数。

如颜色(红色,蓝色);尺码(S,M,L) 三个;那么sku则是 2*3=6个。

sku字段需填写

sku_properties

sku_quantities

sku_prices

sku_outer_ids

sku_barcode

步骤3:图片上传


涉及API

taobao.picture.upload(单张图片上传到图片空间)

taobao.item.img.upload(商品图片上传)

taobao.item.propimg.upload(商品属性图片上传)


步骤4:图片关联


1)商品主图

使用taobao.item.add 接口操作。

说明:可传图文件字节 image,也可传图片链接 pic_path ,两个都传,优先使用pic_path。


2)商品图片关联(发布成功后可以关联,需要商品id)

taobao.item.joint.img


3)属性图片关联(颜色图片,发布成功后可以关联,需要商品id)

涉及API

taobao.item.joint.propimg

参考链接:https://open.taobao.com/api.htm?docId=148&docType=2


步骤5:邮寄选项


注意:后台建好自己的运费模板。

涉及字段:postage_id(运费模板id)。

步骤6:拼接整个商品发布字段


示例:

商品:含有颜色和尺码的衣服;

类目:女装/女士精品(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拼接等)。


五、商品编辑

1. 正常编辑


涉及API

taobao.item.update

编辑的话,所有的属性均可编辑,入参需要传 num_iid。


2. 淘宝增量更新


1)商品和sku价格编辑可使用taobao.item.price.update/taobao.item.sku.price.update

2)商品库存同步taobao.item.quantity.update/taobao.skus.quantity.update (仅限前端商品使用,绑定后端库存或者分销的,请使用其他调用)。


FAQ

关于此文档暂时还没有FAQ
返回
顶部