添加商品图片
添加一张商品图片到num_iid指定的商品中(添加主图边上的图片) , 传入的num_iid所对应的商品必须属于当前会话的用户 如果更新图片需要设置itemimg_id,且该itemimg_id的图片记录需要属于传入的num_iid对应的商品。如果新增图片则不用设置 。 使用taobao.item.seller.get中返回的item_imgs字段获取图片id。 商品图片有数量和大小上的限制,根据卖家享有的服务(如:卖家订购了多图服务等),商品图片数量限制不同。
1.请求参数:
请求URL:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
num_iid | number | 必填 , 商品数字ID | |
item_img | string | 必填 , 图片的base64编码字符串 | |
id | number | 非必填 , 商品图片id(如果是更新图片,则需要传该参数) | |
position | number | 非必填 , 图片序号 | |
is_major | Boolean | 非必填 , 是否将该图片设为主图,可选值:true,false;默认值:false(非主图) | |
is_rectangle | Boolean | 非必填 ,是否3:4长方形图片,绑定3:4主图视频时用于上传3:4商品主图 |
2. 请求示例代码(Java)
@Test
public void itemUpdateImage() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", tb_seller_nick);
// 宝贝Id (必须)
data.put("num_iid", "544876335798");
// 图片序号(非必须)
data.put("position", "1");
// 是否将该图片设为主图,(非必须) , 可选值:true,false;默认值:false(非主图)
data.put("is_major", "false");
// 添加一张商品图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用 , 商品图片内容类型:JPG;最大:3M 。支持的文件类型:jpg,jpeg,png
String base64ImageLogo = Utils.getBase64ImageFromBinary("/Users/tony/Downloads/pdd.jpeg");
data.put("item_img", base64ImageLogo);
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoItemUploadImage ,data);
}
3. 返回结果如下
返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"item_img": {
"created": "2021-02-16 10:33:12",
"id": 994788461262,
"url": "https://img.alicdn.com/bao/uploaded/i4/661153176/O1CN01D5FK851ZKeZ5uhvQH_!!661153176.jpg" //图片链接地址
},
"request_id": "10jf7zssgennw"
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
文档更新时间: 2024-11-15 10:38 作者:admin