增量方式修改天猫商品的规则获取的API。 1.接口返回支持增量修改的字段以及相应字段的规则。 2.如果入参xml_data指定了更新的字段，则只返回指定字段的规则（ISV如果功能性很强，如明确更新Title，请拼装好次字段以提升API整体性能）； 3.ISV初次接入，开发阶段，此字段不填可以看到所有支持增量的字段；但是如果上线功能明确，请尽量遵守第2条 4.如果ISV对字段规则非常清晰，可以直接组装入参数据提交到tmall.item.schema.increment.update进行数据更新。但是最好不要写死，比如每天还是有对此接口功能的一次比对。 ---（感谢爱慕旗舰店提供API命名）
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| item_id | Number | 必须 | 2100529818899 | 需要编辑的商品ID | |
| xml_data | String | 可选 | <?xml version="1.0" encoding="UTF-8"?><itemParam><field id="update_fields" name="更新字段列表" type="multiCheck"><values><value>title</value><value>description</value></values></field></itemParam> | 如果入参xml_data指定了更新的字段，则只返回指定字段的规则（ISV如果功能性很强，如明确更新Title，请拼装好此字段以提升API整体性能） |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| update_item_result | String | <itemRule><field id="update_fields" type="multiCheck"><options><option displayName="商品标题" value="title"/></options></field></itemRule> | 返回增量更新商品的规则文档 |
1 2 3 4 5 6 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);TmallItemIncrementUpdateSchemaGetRequest req = new TmallItemIncrementUpdateSchemaGetRequest();req.setItemId(2100529818899L);req.setXmlData("<?xml version=\"1.0\" encoding=\"UTF-8\"?><itemParam><field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\"><values><value>title</value><value>description</value></values></field></itemParam>");TmallItemIncrementUpdateSchemaGetResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 | <tmall_item_increment_update_schema_get_response> <update_item_result><itemRule><field id="update_fields" type="multiCheck"><options><option displayName="商品标题" value="title"/></options></field></itemRule></update_item_result></tmall_item_increment_update_schema_get_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.invalid-parameter:item_id | 商品id不存在 | 请确认商品是否存在或者已删除，传人正确的商品id |
| isv.invalid-permission:item-deleted | 商品已删除 | 换正确的商品id |
| isp.tmall_item_service_error | 服务错误，稍后重试 | 服务错误，稍后重试 |
| isv.parameter-parase-error:xml_data | 入参数据无法被转换识别 | 参数格式错误，参考api文档说明入参 |
| isv.invalid-permission:update_item | 该商品不属于当前用户 | 获取当前用户的商品重试 |
| isv.invalid-permission:publish_itemupdate_item | C卖家没有调用天猫服务层接口发布或编辑商品的权限 | 带tmall 字样的schema接口，仅支持天猫商家；淘宝用户使用带taobao 字样的schema接口 |
| isp.tmallitem-service-error:empty | 系统异常 | 请稍后重试 |
| isv.invalid-parameter:category-not-found | 商品类目参数有问题 | 请检查商品类目 |
| isv.invalid-parameter:cid | 商品cid参数异常 | 请检查商品cid参数 |
| isv.invalid-parameter:item-not-found | 商品不存在 | 请检查商品id |
| isp.service-unavailable | 系统错误 | 偶尔出现重试，频繁出现反馈平台 |
| isv.invalid-parameter:empty | 系统异常 | 请求稍后重试 |
| isv.invalid-parameter:category-frozen | 商品类目异常 | 请求检查商品类目是否正确 |
| isv.parameter-parse-error:xml_data | xml_data内容异常 | 请检查xml_data内容是否正确 |
| isv.invalid-parameter:cid;isp.tmallitem-service-error:empty | 系统繁忙，请稍后重试 | 系统繁忙，请稍后重试 |
| isp.tmallitem-service-error:empty;isv.invalid-parameter:cid | 系统繁忙，请稍后重试 | 系统繁忙，请稍后重试 |
| isp.tmallitem-service-error:empty;isv.invalid-parameter:cid;isv.invalid-parameter:empty;isp.tmallitem-service-error:empty | 系统繁忙，请稍后重试 | 系统繁忙，请稍后重试 |
| isp.system-service-error:empty | 系统繁忙，请稍后重试 | 系统繁忙，请稍后重试 |
| isp.system-service-error:sell_points | 参数sell_points格式不正确 | 请检查sell_points参数格式，修改后再提交 |
| isv.invalid-parameter:cid;isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty | 服务错误，稍后重试 | 服务错误，稍后重试 |
| SYS_REQUEST_TOO_FAST | 请求过快，请降低请求频率 | 按照限定阈值进行请求（单个店铺每分钟上限为2000次） |