淘宝开放平台

登录
文档中心 > API类目 > 商品编辑

商品编辑

taobao.item.promotion.rule.get (获取商品已生效营销活动更新规则)

获取商品已生效的更新规则信息，主要包含库存禁止修改，商品一口价禁止修改，库存减少锁定等规则生效信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 1231231231 商品ID

响应参数

名称 类型 示例值 描述
rules ItemPromotionRule [] {} 商品规则信息
  • └ name
  • String
  • 2020淘宝新势力周秋（天猫）
  • 规则名称
  • └ message
  • String
  • 该商品为#2020淘宝新势力周秋#活动商品，当前时间段不允许做修改商品一口价操作
  • 规则描叙信息
  • └ start_time
  • String
  • 2020-08-22 23:59:59
  • 规则生效开始时间
  • └ end_time
  • String
  • 2020-08-27 23:59:59
  • 规则生效结束时间
  • └ type
  • String
  • 一口价禁止修改规则
  • 规则类型，常见有SKU锁定规则,下架锁定规则,库存减少锁定规则,库存禁止修改规则,一口价禁止修改规则
effec Boolean true 商品是否命中更新规则

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
?
1
2
3
4
5
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemPromotionRuleGetRequest req = new ItemPromotionRuleGetRequest();
req.setItemId(1231231231L);
ItemPromotionRuleGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
?
1
2
3
4
5
6
7
8
9
10
11
12
<item_promotion_rule_get_response>
    <rules>
        <item_promotion_rule>
            <name>2020淘宝新势力周秋（天猫）</name>
            <message>该商品为#2020淘宝新势力周秋#活动商品，当前时间段不允许做修改商品一口价操作</message>
            <start_time>2020-08-22 23:59:59</start_time>
            <end_time>2020-08-27 23:59:59</end_time>
            <type>一口价禁止修改规则</type>
        </item_promotion_rule>
    </rules>
    <effec>true</effec>
</item_promotion_rule_get_response>

异常示例

  • XML示例
  • JSON示例
?
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.item.invalid-itemId 商品不存在或者已经删除 商品不存在或者已经删除，请不要重复调用
isv.item.invalid-seller
isp.call-limited

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部