添加一张商品属性图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用户 图片的属性必须要是颜色的属性,这个在前台显示的时候需要和sku进行关联的 商品属性图片只有享有服务的卖家(如:淘宝大卖家、订购了淘宝多图服务的卖家)才能上传 商品属性图片有数量和大小上的限制,最多不能超过24张(每个颜色属性都有一张)。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
num_iid | Number | 必须 | 123456 | 商品数字ID,必选 | |
id | Number | 可选 | 123456 | 属性图片ID。如果是新增不需要填写 | |
properties | String | 必须 | 1627207:28326 | 属性列表。调用taobao.itemprops.get获取类目属性,属性必须是颜色属性,再用taobao.itempropvalues.get取得vid。格式:pid:vid。 | |
position | Number | 可选 | 122 |
|
图片位置 |
image | byte[] | 可选 | 我是被上传的文件内容 |
|
属性图片内容。类型:JPG,GIF;图片大小不超过:3M |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
prop_img | PropImg | PropImg属性图片结构 | |
|
1 2 3 4 5 6 7 8 9 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); ItemPropimgUploadTmallRequest req = new ItemPropimgUploadTmallRequest(); req.setNumIid(123456L); req.setId(123456L); req.setProperties( "1627207:28326" ); req.setPosition(122L); req.setImage( new FileItem( "/tmp/file.txt" )); ItemPropimgUploadTmallResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 | < item_propimg_upload_tmall_response > < prop_img > < id >1646146</ id > < created >2000-01-01 00:00:00</ created > </ prop_img > </ item_propimg_upload_tmall_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.missing-parameter:image | 缺少必要的参数:image | 前端做好校验,上传属性图的时候必须传入图片 |
isv.item-get-service-error:ITEM_NOT_FOUND | 没有找到宝贝 | 商品被删除或不存在,直接更新本地数据库,将旧的商品删除 |
isv.item-image-upload-service-error:ITEM_NOT_FOUND | 没有找到宝贝 | 商品被删除或不存在,直接更新本地数据库,将旧的商品删除 |
isv.image-not-exist:invalid-image-id | image 不存在 | 通过taobao.item.get获取到图片id之后再对其进行更新 |
isv.item-is-delete:invalid-numIid-or-iid | 该商品已被删除 | 通过增量接口taobao.increment.items.get获取被删除的商品,在本地数据库更新,出现此错误不要重试 |
isv.picture-service-error | 上传图片到图片空间报错 | 首先,要在前端对上传的图片进行大小校验:图片大小限3M以下, 其次,在前端对于图片类型要做好校验:只支持jpg、jpeg、gif、png、zip这几种类型的图片。 最后,在前端可以在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击图片。 |
isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.item-get-service-error:QUERY_USER_INFO_ERROR | 系统错误,获取用户数据失败 | 系统错误,获取用户数据失败 |
isv.item-image-upload-service-error:ICDB_QPS_LIMIT | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.item-image-upload-service-error:QUERY_USER_INFO_ERROR | 系统错误,获取用户数据失败 | 系统错误,获取用户数据失败 |