文档中心 > API类目 > 全球速卖通-营销管理

aliexpress.marketing.storepromotions.list (查询商家营销活动列表)

查询商家营销活动列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
promotion_query_dto PromotionQueryDto 可选 查询参数
  • └ promotion_name
  • String
  • 可选
  • 五折专区
  • 活动名称
  • └ promotion_type
  • String
  • 必须
  • ProductDiscount
  • 活动类型:单品折扣:ProductDiscount;搭配套餐:BundleDeals;拼团:GroupBuy;满件折:OrderQuantityDiscount;满立减:OrderPriceDiscount;满包邮:FreeShipping;
  • └ current_page
  • Number
  • 必须
  • 1
  • 页码
  • └ page_size
  • Number
  • 必须
  • 20
  • 页大小
  • └ promotion_id
  • Number
  • 可选
  • 1234567890
  • 活动ID
  • └ status
  • String
  • 可选
  • Ongoing
  • 活动状态:未开始:NotStarted;进行中:Ongoing;已暂停:Invalid;已结束:Finished;

响应参数

名称 类型 示例值 描述
current_page Number 1 当前页码
page_size Number 20 页大小
total_count Number 100 总记录数
data_list PromotionSimpleInfoDto [] 详细参考如下 出参集合
  • └ promotion_id
  • Number
  • 1234567890
  • 活动ID
  • └ promotion_name
  • String
  • 五折专区
  • 活动名称
  • └ start_time
  • String
  • 2018-12-12 12:12:10
  • 活动开始时间
  • └ end_time
  • String
  • 2018-12-12 12:12:10
  • 活动结束时间
  • └ status
  • String
  • Ongoing
  • 活动状态:未开始:NotStarted;进行中:Ongoing;已暂停:Invalid;已结束:Finished;

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressMarketingStorepromotionsListRequest req = new AliexpressMarketingStorepromotionsListRequest();
AliexpressMarketingStorepromotionsListRequest.PromotionQueryDto obj1 = new AliexpressMarketingStorepromotionsListRequest.PromotionQueryDto();
obj1.setPromotionName("五折专区");
obj1.setPromotionType("ProductDiscount");
obj1.setCurrentPage(1L);
obj1.setPageSize(20L);
obj1.setPromotionId(1234567890L);
obj1.setStatus("Ongoing");
req.setPromotionQueryDto(obj1);
AliexpressMarketingStorepromotionsListResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_marketing_storepromotions_list_response>
    <current_page>1</current_page>
    <page_size>20</page_size>
    <total_count>100</total_count>
    <data_list>
        <promotion_simple_info_dto>
            <promotion_id>1234567890</promotion_id>
            <promotion_name>五折专区</promotion_name>
            <start_time>2018-12-12 12:12:10</start_time>
            <end_time>2018-12-12 12:12:10</end_time>
            <status>Ongoing</status>
        </promotion_simple_info_dto>
    </data_list>
</aliexpress_marketing_storepromotions_list_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

返回
顶部