场景说明: 商家需要将外部系统的商品同步至有赞,在有赞商城出售,同时在后期能够对商品的信息进行维护更新。
——微商城后台-商品-商品管理界面,点击“发布商品”可以添加需要出售的商品;填写商品详细信息后点击下一步,对商品添加一些详情描述就可以发布商品了;
——添加完成后,即可在商品管理中看到已添加的商品,如果想推广该商品,可以点击商品右侧的“推广商品”获取推广二维码及推广链接;
——通过哪个接口可以将外部系统的商品一键同步到有赞?或者如何通过接口在商城后台新增商品? (1)商品创建接口:youzan.item.create (3)重要字段说明: 》》desc:商品描述,字数要大于5个字符,小于25000个字符 ,受违禁词控制;格式如: <p>详情描述测试</p><p><imgdata-origin-width="800" data-origin-height="800"src="https://img.yzcdn.cn/test.jpg" /></p>,如果有多张图片需要添加,可以将多张图片放在一个<p>…</p>结构中;当然,此处格式不固定,如果自身有前端开发同事,也可以自己写内容模板; 》》item_no:商品货号,商家为商品设置的外部编号,对应有赞微商城后台-商品管理-商品编辑信息中的商品编码;主要用于外部系统也有自己的商品编号的场景,用于和有赞的商品ID形成关联,方便运营管理; 》》price:价格,此字段需要注意的点是单位是“分”; 》》title:商品标题,不能超过100字,受违禁词控制; 》》sku_stocks:sku 的JSON字符串,传入一定要按照这个格式: [ { "price":10000, "quantity":100,"item_no":"MOYU-1", "skus":[ { "k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"1024G", }] }, { "price":10000, "quantity":100,"item_no":"MOYU-2","skus":[ {"k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"16G", } ]} ] price是 sku 价格,quantity 是sku 的库存,item_no 是 sku 的商家编码,k 是规格名称,v 是规格值名称,要注意:sku_stocks数量=规格1数量 * 规格2数量 * 规格3数量,即使有的SKU搭配是没有的,也要以库存0的形式传进来,否则会报错sku信息不完整; 》》sku_images:SKU图片,仅支持第一级规格, 参数一定要与sku_stocks参数匹配, 如sku_stocks参数是这样的 [ {"price":10000, "quantity":100,"item_no":"MOYU-1", "skus":[ { "k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"1024G", }] }, { "price":10000, "quantity":100,"item_no":"MOYU-2","skus":[ {"k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"16G", } ]} ] 颜色就是第一级规格。它下面的规格只有“绿色”这一项,sku_images应该与之一一对应,如下 : [{“v":"绿色","img_url":"www.youzan.com"}] 请务必按此格式传参数,不然校验通不过,无法新增商品 (4)调用格式,通过(2)中链接访问后: (5)HTTP调用示例: (6)JAVA调用示例: YZClient client = new DefaultYZClient(new Token("token")); //new Sign(appKey, appSecret) YouzanItemCreateParams youzanItemCreateParams= new YouzanItemCreateParams(); youzanItemCreateParams.setTitle("aaatest-standard5566"); youzanItemCreateParams.setPrice(10000L); youzanItemCreateParams.setImageIds("9518"); youzanItemCreateParams.setDesc("http://n.sinaimg.cn/mil/8_img/upload/f8bc40b5/20180929/-Bec-fyhwret0362019.jpg"); youzanItemCreateParams.setItemNo("6933285600396"); youzanItemCreateParams.setSkuImages("[{"v":"22","img_url":"https://img.yzcdn.cn/upload_files/2018/09/24/1a6004ee7c5ecd970affba1999c7e0e1.jpg"}]"); youzanItemCreateParams.setSkuStocks("[{"sku_id":3337,"code":"sdsfdsfs","price":10000,"quantity":100,"skus":[{"k":"颜色","kid":1,"v":"22","vid":1196}]}]"); youzanItemCreateParams.setAutoListingTime(332222L); YouzanItemCreate youzanItemCreate = new YouzanItemCreate(); youzanItemCreate.setAPIParams(youzanItemCreateParams); YouzanItemCreateResult result =client.invoke(youzanItemCreate);
——商品信息发生变化,如何更新商品信息?微商城后台-商品管理,点击编辑按钮即可修改商品信息;
——通过哪个接口可以更新商品信息? (1)商品信息更新接口:youzan.item.update (3)重要字段说明: 其他字段同以上商品创建接口,不再做说明; (4)调用格式,通过(2)中链接访问后: (5)HTTP请求示例: (6)JAVA请求示例: YZClient client = new DefaultYZClient(new Token("token")); //new Sign(appKey, appSecret) YouzanItemUpdateParams youzanItemUpdateParams= new YouzanItemUpdateParams(); youzanItemUpdateParams.setTitle("有赞测试"); youzanItemUpdateParams.setPrice(9999L); youzanItemUpdateParams.setItemId(5260002L); youzanItemUpdateParams.setNum(44L); youzanItemUpdateParams.setDesc("测试测试测试"); YouzanItemUpdate youzanItemUpdate = new YouzanItemUpdate(); youzanItemUpdate.setAPIParams(youzanItemUpdateParams); YouzanItemUpdateResult result =client.invoke(youzanItemUpdate);
|