文档中心 > API类目 > 五道口营销域

alibaba.wdk.marketing.itembuygift.queryitems (查询买赠活动下的商品)

查询买赠活动下的商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param ActivitySkuQuery 必须 查询入参
  • └ activity_id
  • Number
  • 必须
  • 123456
  • 五道口活动id
  • page
  • BasePageQuery
  • 必须
  • 分页信息
  • └ page_size
  • Number
  • 必须
  • 20
  • 分页大小
  • └ current
  • Number
  • 必须
  • 1
  • 当前分页,从1开始
  • └ out_act_id
  • String
  • 可选
  • sanjiang170907
  • 商家活动id
  • └ sku_codes
  • String []
  • 可选
  • [12513, 12514]
  • 需要查询的商品skuCodes

响应参数

名称 类型 示例值 描述
result MarketPageResult 查询返回结果
  • └ message
  • String
  • 请求参数非法
  • 错误信息
  • └ total
  • Number
  • 100
  • 参加当前活动的商品总数
  • └ page_size
  • Number
  • 20
  • 页面大小
  • └ error_code
  • String
  • REQUEST_PARAM_ERROR
  • 错误码
  • sku_list
  • Data []
  • 参加活动的买赠商品详情列表
  • limit_info
  • LimitInfo
  • 通用限购信息,-1为不限制,默认为不限制
  • └ total_limit_cnt
  • Number
  • 100
  • 活动期间总限购
  • └ user_limit_cnt
  • Number
  • 10
  • 每人活动期间总限购
  • └ user_daily_limit_cnt
  • Number
  • 2
  • 每人每日限购
  • └ gift_sku_name
  • String
  • 赠品的名称
  • 赠品的名称
  • └ gift_sku_code
  • String
  • 12345
  • 赠品的skuCode,如果和主商品的skuCode相同,则为买A赠A;如果不同,则为买A赠B
  • └ buy_num
  • Number
  • 4
  • 买N赠1的N
  • └ item_shop_relation
  • String
  • {2300929749296:1000847028}
  • 淘宝item和shop的对应关系, k-itemId, v-shopId
  • └ sku_name
  • String
  • 主商品名称
  • 主商品名称
  • └ sku_code
  • String
  • 12513
  • 主商品的skuCode
  • └ current
  • Number
  • 1
  • 当前分页
  • └ total_page
  • Number
  • 10
  • 总页数
  • └ success
  • Boolean
  • true
  • 调用api是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkMarketingItembuygiftQueryitemsRequest req = new AlibabaWdkMarketingItembuygiftQueryitemsRequest();
AlibabaWdkMarketingItembuygiftQueryitemsRequest.ActivitySkuQuery obj1 = new AlibabaWdkMarketingItembuygiftQueryitemsRequest.ActivitySkuQuery();
obj1.setActivityId(123456L);
AlibabaWdkMarketingItembuygiftQueryitemsRequest.BasePageQuery obj2 = new AlibabaWdkMarketingItembuygiftQueryitemsRequest.BasePageQuery();
obj2.setPageSize(20L);
obj2.setCurrent(1L);
obj1.setPage(obj2);
obj1.setOutActId("sanjiang170907");
obj1.setSkuCodes("12513, 12514");
req.setParam(obj1);
AlibabaWdkMarketingItembuygiftQueryitemsResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_wdk_marketing_itembuygift_queryitems_response>
    <result>
        <message>请求参数非法</message>
        <total>100</total>
        <page_size>20</page_size>
        <error_code>REQUEST_PARAM_ERROR</error_code>
        <sku_list>
            <data>
                <limit_info>
                    <total_limit_cnt>100</total_limit_cnt>
                    <user_limit_cnt>10</user_limit_cnt>
                    <user_daily_limit_cnt>2</user_daily_limit_cnt>
                </limit_info>
                <gift_sku_name>赠品的名称</gift_sku_name>
                <gift_sku_code>12345</gift_sku_code>
                <buy_num>4</buy_num>
                <item_shop_relation>{2300929749296:1000847028}</item_shop_relation>
                <sku_name>主商品名称</sku_name>
                <sku_code>12513</sku_code>
            </data>
        </sku_list>
        <current>1</current>
        <total_page>10</total_page>
        <success>true</success>
    </result>
</alibaba_wdk_marketing_itembuygift_queryitems_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

返回
顶部