oAuth2.0商品发布API接口,店铺上传接口,店铺商品发布接口,超详细的介绍

oAuth2.0商品发布API接口,店铺上传接口,店铺商品发布接口,超详细的介绍,第1张

一、新商品发布接口,商品上下架接口,店铺上传接口,新的接口对接方式文档如下:
第一步:打开开放平台链接:https://open.taobao.com/docV3.htm?spm=a219a.7386797.0.0.2fc9669aDlsu7s&source=search&docId=119447&docType=1
第二步:找到对应的商品发布接口,点击注册key和secret
把要测试的店铺填写至注册的账号内。
第三步:注册好了key进行店铺授权,进入淘宝应用市场拿到店铺授权session id,
第四步: 提供请求示例,即可拿到商品发布功能接口,及上下架接口。
二、应用场景: 店铺补货,店铺上下架商品,店铺管理,等业务。
三、相关接口:
1,商品发布
a)获取商品发布规则信息:alibaba.item.publish.schema.get
b)商品级联属性信息获取:alibaba.item.publish.props.get
c)商品发布:alibaba.item.publish.submit
2,商品编辑
a)商品编辑获取schema信息:alibaba.item.edit.schema.get
b)商品编辑提交schema信息:alibaba.item.edit.submit
c)商品增量编辑:alibaba.item.edit.fastupdate
3,商品管理
a)商品上架:alibaba.item.operate.upshelf
b)商品下架:alibaba.item.operate.downshelf
c)商品删除:alibaba.item.operate.delete
四、商品新发步骤
步骤一: 确定已授权的类目和品牌
涉及接口:
taobao.itemcats.authorize.get
taobao.itemcats.get
步骤二: 发布产品
说明:天猫商品需要挂靠产品,所以产品发布仅支持天猫店铺;淘宝 和 特价版商品无需挂靠产品,不需要产品发布,直接按照“步骤三”发布商品即可。
涉及接口:
tmall.product.match.schema.get( 获取匹配产品规则 )
tmall.product.schema.match( product匹配接口 )
tmall.product.schema.get( 产品信息获取schema获取 )
tmall.product.add.schema.get( 产品发布规则获取接口 )
tmall.product.schema.add( 使用Schema文件发布一个产品 )
类目:女装/女士精品 >> POLO衫(类目id:201241307) 为例说明产品发布步骤;
1、产品匹配规则获取
涉及API:tmall.product.match.schema.get
参考示例:http://open.taobao.com/api.htm?source=search&docId=23258&docType=2
入参:category_id = 201241307;
出参:规则xml
如果没有返回产品匹配规则,说明该类目不需要发布产品,直接到"步骤三: 发布商品"。
2、产品匹配
涉及API:tmall.product.schema.match
参考示例:http://open.taobao.com/api.htm?source=search&docId=23259&docType=2
入参:category_id = 201241307;propvalues = xml_data(示例XML如下)

10000497 2157813 出参:产品id;product_id = 1459669507 ; 调用tmall.product.schema.get查询产品状态【】 产品状态(true)如果返回true则可以直接发布商品(直接到"步骤三: 发布商品"。) 产品状态(false)如果返回false则需要等待。 3、产品发布规则获取,如果上一步(产品匹配)没有匹配到产品,需要自己添加; 涉及API: tmall.product.add.schema.get 参考示例:http://open.taobao.com/api.htm?docId=23257&docType=2 入参:category_id = 201241307 ; brand_id = 10000497 出参:规则xml 4、产品发布,根据上一步取到的规则组装xml 涉及API: tmall.product.schema.add 参考示例:http://open.taobao.com/api.htm?docId=23260&docType=2 入参:category_id = 201241307 ; brand_id = 10000497 ; xml_data ; 出参:产品id product_id; 调用tmall.product.schema.get查询产品状态【】 产品状态(true)如果返回true则可以直接发布商品(直接到"步骤三: 发布商品"。) 产品状态(false)如果返回false则需要等待。 注意:部分产品发布后需要审核通过后才可使用,所以需要等待产品状态可用后再发布商品。 备注:1、如果获取产品规则tmall.product.add.schema.get获取为空时,说明该类目为无关键属性类目,直接去发布商品即可。 2、产品schema 接口继续使用老的schema SDK 协议; 新老schema协议差异 1) 字段 老协议 新协议 是否变动 ComplexField complex-values complex-value 是 MultiComplexField complex-values complex-values 否 2)所有field的default-complex-values/default-values/default-complex-value/default-value都已取消,统一用field的值取代。 步骤三: 发布商品(编辑商品) 当第二步的产品可用后,即可发布商品 商品规则获取 调用alibaba.item.publish.schema.get获取类目和属性规则 商品级联属性信息获取 调用alibaba.item.publish.props.get,当alibaba.item.publish.schema.get接口返回的某些属性的值特别多时,会提示使用此接口。根据入参获取商品级联属性信息(基本很少用到),比如alibaba.item.publish.schema.get返回如下结果是: 商品发布alibaba.item.publish.submit进行商品上新 (注意 涉及图片上传时请使用taobao.picture.upload接口) 备注:当发布天猫商品时,偶尔会遇到报[isv.item-service-error:ITEM_PROPERTIES_ERROR–“xxx”属性出错:类目属性在标准属性中不存在]这一类错误时,一般是由于行业小二对类目属性进行了调整,(需要去第二步编辑产品)需要调用tmall.product.update.schema.get接口获取产品更新规则,检查是否有必填元素的value为空,重新生成产品更新信息xml调用tmall.product.schema.update接口完成补充即可 涉及接口: alibaba.item.publish.schema.get alibaba.item.publish.props.get alibaba.item.publish.submit TIPS:开发者如果涉及需要获取某一类目下的商品上新的所有规则,可以同时调用tmall.product.add.schema.get接口获取产品发布涉及的规则,然后入参需要注意spu_id传入0 调用alibaba.item.publish.schema.get获取商品发布的通用规则(非全部规则) 七、商品编辑更新 涉及接口: a)商品编辑获取schema信息:alibaba.item.edit.schema.get b)商品编辑提交schema信息:alibaba.item.edit.submit c)商品增量编辑:alibaba.item.edit.fastupdate 更新分类 全量更新(除局部更新外的均需要走全量更新) 局部更新(局部更新API) 1、编辑规则获取 涉及API:alibaba.item.edit.schema.get 参考示例:https://open.taobao.com/api.htm?docId=53943&docType=2 说明:全量和增量编辑的规则都使用接口alibaba.item.edit.schema.get 获取。 增量编辑规则获取还需入参 fields,比如传入fields=title ,接口alibaba.item.edit.schema.get只获取 title 的编辑规则。 2、全量编辑 涉及API:alibaba.item.edit.submit 参考示例:https://open.taobao.com/api.htm?docId=53968&docType=2 3、增量编辑 涉及API:alibaba.item.edit.fastupdate 参考示例:https://open.taobao.com/api.htm?docId=54542&docType=2 说明: A)目前淘宝支持的增量更新字段有:catId,bizIdentity,id,price,quantity,title,wirelessDesc,desc,barcode,outerId,video,images,recommendReason,imageVideo,sellPromise sku 信息支持修改已有sku的规格、图片、价格、数量、商家编码、条形码,但不能新增(删除)sku;新增sku要用全量接口。 B)天猫市场支持增量更新的字段如下: title(标 题) subtitle(子标题,即卖点) show_title (展示标题) short_title(无线短标题) description(商品描述) wireless_desc (旺铺无线详情描述) vertical_image(竖图) white_bg_image (白底图) large_screen_image (电子大屏图) shop_category (店铺类目) item_image(主图) item_wireless_images(无线主图) postage_id_increment(运费模板id) image_video_type (主图视频比例类型) main_video (主图视频) three_to_four_images (3:4商品图片) 说明:关于主图视频,目前商品已经支持3:4主图视频,并且支持3:4商品主图图片更新,建议三个字段为一个组件来使用; 如果 image_video_type 选择1:1或者16:9类型,那么main_video 需要传值1:1或者16:9类型的视频,此时three_to_four_item_images 这个字段,不管你传值与否,都不会生效。 如果 image_video_type 选择3:4类型,那么 main_video 需要传值3:4类型视频,且需要同时传three_to_four_item_images 这个字段。 C)特价版支持增量更新的字段如下: title(宝贝标题) catProp(类目属性) 支持修改枚举类型字段,不支持修改input类型的字段; sku(宝贝销售规格)支持修改已有sku的价格、库存、商家编码等信息,但不能新增sku;新增sku要用全量接口alibaba.item.edit.submit,并且先设置销售属性; price(特价) 需与marketPrice同时修改; marketPrice(划线价) 需与price同时修改; quantity(总数量) outerId(商家编码) images(宝贝图片) clearImage(非牛皮癣图) imageVideo(主图视频) verticalImage(宝贝长图) desc(商品描述) subStock(库存计数) tbDeliveryTime(发货时效) deliveryTimeSetBySku(按宝贝规格设置发货时间) 需与“sku-相对发货时间” 字段同时修改; tbExtractWay(运费) invoice(提供发票) warranty(保修服务) sellPromise(退换货承诺) sevenDaySupport、sevenDayOptional(七天退货) TIPS1:建议开发者将增量接口支持的每个元素独立封装,这样性能上更优越,报错也会更少。

API 工具
API SDK调用示例
APISDK下载
API测试工具

欢迎分享,转载请注明来源:内存溢出

原文地址: http://outofmemory.cn/web/1297203.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2022-06-10
下一篇 2022-06-10

发表评论

登录后才能评论

评论列表(0条)

保存