文档中心 > API类目 > 小活动开放API

taobao.activity.item.info.query (通过商品选择器翻页查询商品信息)

通过商品选择器翻页查询商品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_id String 可选 xxxxx 活动ID,会标记当前活动中已选商品
cur_page Number 必须 1 当前页码
page_size Number 必须 10 分页大小,最大20
item_id Number 可选 3 商品id
item_ids String 可选 581535339218,581534899451,734015818058 多商品id,逗号分隔,最多20
item_name String 可选 xxxxx 商品名称
act_start_time Number 可选 1699632000000 活动开始时间
act_end_time Number 可选 1699732000000 活动结束时间
promotion_level Number 必须 1 优惠级别,1-商品级,3-sku级
activity_source String 必须 SINGLE_TREASURE 活动类型

响应参数

名称 类型 示例值 描述
total_count Number 998 数据总数
tao_activity_items_find_resp_list TaoActivityItemsFindResp [] 响应结果
  • └ title
  • String
  • 测试品牌测试商品,请不要拍,测试商品,请不要拍2
  • 商品名称
  • └ item_id
  • Number
  • 581535339218
  • 商品id
  • └ available_flag
  • Boolean
  • true
  • 是否有货
  • └ pic_url
  • String
  • //img.alicdn.com/bao/uploaded/i1/263694008/O1CN01HJjptP1fThulet0YL_!!0-item_pic.jpg_480x480.jpg
  • 商品图片
  • └ ic_price
  • String
  • 1000.00
  • 商品原价
  • └ is_optional
  • Boolean
  • false
  • 是否可选
  • └ optional_reason
  • String
  • 已在其他活动中使用
  • 不可选原因
  • └ is_participated_item
  • Boolean
  • false
  • 商品是否参与当前活动
  • sku_list
  • SkuBaseVo []
  • skuVOs
  • └ sku_id
  • Number
  • 4053200027223
  • skuId
  • └ price
  • String
  • 43.40
  • 价格
  • └ props
  • String
  • 灰色 12345
  • 详情
  • └ available_flag
  • Boolean
  • true
  • 是否有货

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ActivityItemInfoQueryRequest req = new ActivityItemInfoQueryRequest();
req.setActivityId("xxxxx");
req.setCurPage(1L);
req.setPageSize(10L);
req.setItemId(3L);
req.setItemIds("581535339218,581534899451,734015818058");
req.setItemName("xxxxx");
req.setActStartTime(1699632000000L);
req.setActEndTime(1699732000000L);
req.setPromotionLevel(1L);
req.setActivitySource("SINGLE_TREASURE");
ActivityItemInfoQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<activity_item_info_query_response>
    <total_count>998</total_count>
    <tao_activity_items_find_resp_list>
        <tao_activity_items_find_resp>
            <title>测试品牌测试商品,请不要拍,测试商品,请不要拍2</title>
            <item_id>581535339218</item_id>
            <available_flag>true</available_flag>
            <pic_url>//img.alicdn.com/bao/uploaded/i1/263694008/O1CN01HJjptP1fThulet0YL_!!0-item_pic.jpg_480x480.jpg</pic_url>
            <ic_price>1000.00</ic_price>
            <is_optional>false</is_optional>
            <optional_reason>已在其他活动中使用</optional_reason>
            <is_participated_item>false</is_participated_item>
            <sku_list>
                <sku_base_vo>
                    <sku_id>4053200027223</sku_id>
                    <price>43.40</price>
                    <props>灰色 12345</props>
                    <available_flag>true</available_flag>
                </sku_base_vo>
            </sku_list>
        </tao_activity_items_find_resp>
    </tao_activity_items_find_resp_list>
</activity_item_info_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部