taobao.promotionmisc.common.item.activity.add (创建通用单品优惠活动)

创建通用单品优惠活动。 1、该接口只创建活动的基本信息,如需要增加、删除参与该活动的商品及优惠,请调用taobao.promotionmisc.common.item.detail.add和taobao.promotionmisc.common.item.detail.delete接口 2、同一卖家下的活动数量限制为30个,超过限制需先调用taobao.promotionmisc.common.item.activity.delete接口删除无用的活动后才可再创建新的活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
description String 必须 秋季新款低价促销
  • 最大长度:100
  • 活动描述,不能超过100字符
    end_time Date 必须 2015-12-01 10:00:00 活动结束时间
    name String 必须 秋季促销
  • 最大长度:32
  • 活动名称,不能超过32字符
    start_time Date 必须 2015-10-27 10:00:00 活动开始时间
    user_tag String 可选 NEW_3294304 用户标签。当is_user_tag为true时,该值才有意义。
    is_user_tag Boolean 可选 false
  • 默认值:false
  • 是否指定人群标签

    响应参数

    名称 类型 示例值 描述
    activity_id Number 12345 优惠活动ID
    is_success Boolean true 是否创建成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PromotionmiscCommonItemActivityAddRequest req = new PromotionmiscCommonItemActivityAddRequest();
    req.setDescription("秋季新款低价促销");
    req.setEndTime(StringUtils.parseDateTime("2015-12-01 10:00:00"));
    req.setName("秋季促销");
    req.setStartTime(StringUtils.parseDateTime("2015-10-27 10:00:00"));
    req.setUserTag("NEW_3294304");
    req.setIsUserTag(false);
    PromotionmiscCommonItemActivityAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <promotionmisc_common_item_activity_add_response>
        <activity_id>12345</activity_id>
        <is_success>true</is_success>
    </promotionmisc_common_item_activity_add_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:xxx 参数无效 修正调用参数后重试
    isv.activity-count-exceeds-max-number 卖家有效的优惠活动数量超过了限制 删除旧的不再使用的活动后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部