文档中心 > 基础技术

淘宝商品发布编辑示例

更新时间:2019/06/17 访问次数:7421

一:淘宝现状

  1. 淘宝没有schema接口,发布较原始,具体依赖就是类目属性值
  2. 发布字段枚举值可从类目属性值选,自定义的可输入
  3. 发布较宽松,字段大部分可选

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

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

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

涉及API

taobao.itemcats.authorize.get(授权类目和品牌)
taobao.itemcats.get(可供发布的类目)
taobao.itemprops.get( 获取标准商品类目属性 )
taobao.itempropvalues.get( 获取标准类目属性值 )

可发类目获取

taobao.itemcats.get

入参: parent_cid=0
出参:所有的可供发布的一级类目

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

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

标准商品类目属性获取

taobao.itemprops.get

入参:cid=1512(手机类目) 其他选填
出参:所有的一级类目属性项和属性值

获取标准类目属性值

taobao.itempropvalues.get

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

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

三:商品发布

涉及API

taobao.item.add

发布概述

商品的属性

  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. 非销售属性拼接

2.1 普通属性值枚举
拼接步骤:
写入props字段, pid:vid 填入,pid vid 来自类目属性值获取的结果

2.2 普通自定义输入属性值
拼接步骤:
写入input_pids,input_str ,不写入props

3. 销售属性拼接

2.1 枚举值的销售属性
拼接步骤:
1. 写入props
2. 写入sku_properties

2.2 自定义的销售属性
拼接步骤:
需要写入input_custom_cpv,写入props,写入sku_properties

2.3 自定义的销售属性项、自定义销售属性值
拼接步骤:
自定义销售属性项不写入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
参考链接://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拼接等)

四:商品编辑

正常编辑

涉及API
taobao.item.update

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

淘宝增量更新

FAQ

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