文档中心 > API类目 > 交易开放

taobao.opentrade.group.sync (组团购场景创建或更新组团活动)

组团购场景中创建团购活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 1233 商品ID
discount_price Number 必须 1000 组团购买的折扣价,单位为分
fail_process String 可选 close
  • 默认值:close
  • 未成团处理办法,close:系统关单;continue:订单继续下行
    open_limit Number 可选 1
  • 默认值:0
  • 组团类型为团购,可限制团长针对一个商品的开团数量上限
    allow_white_list String [] 可选 ["用户1","用户2"]
  • 最大列表长度:999
  • 允许开团的淘宝账号列表
    allow_type String 可选 all
  • 默认值:all
  • 是否任何账号可开团。whitelist:仅白名单账号可开团 all:任何账号可开团
    group_type Number 必须 0 组团类型,0:拼团;1:团购
    goal Number 必须 5 成团的目标人数
    expiration Number 必须 3600 成团有效期,单位为妙
    end_time Date 必须 2020-09-10 10:00:00 组团活动结束时间
    start_time Date 必须 2020-09-01 10:00:00 组团活动开始时间
    group_activity_id Number 可选 11111 组团活动id

    响应参数

    名称 类型 示例值 描述
    result GroupActivityResponse {} 团购活动信息
    • └ item_id
    • Number
    • 1234
    • 商品id
    • └ discount_price
    • Number
    • 1000
    • 组团购买的折扣价,单位为分
    • └ fail_process
    • String
    • close
    • 未成团处理办法,close:系统关单;continue:订单继续下行
    • └ open_limit
    • Number
    • 1
    • 组团类型为团购,可限制团长针对一个商品的开团数量上限
    • └ allow_white_list
    • String []
    • ["用户1","用户2"]
    • 允许开团的淘宝账号列表
    • └ allow_type
    • String
    • all
    • 是否任何账号可开团。whitelist:仅白名单账号可开团 all:任何账号可开团
    • └ group_type
    • Number
    • 0
    • 组团类型,0:拼团;1:团购
    • └ goal
    • Number
    • 5
    • 成团的目标人数
    • └ expiration
    • Number
    • 3600
    • 成团有效期,单位为妙
    • └ end_time
    • Date
    • 2020-09-10 10:00:00
    • 组团活动结束时间
    • └ start_time
    • Date
    • 2020-09-01 10:00:00
    • 组团活动开始时间
    • └ group_activity_id
    • Number
    • 111111
    • 团购活动id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpentradeGroupSyncRequest req = new OpentradeGroupSyncRequest();
    req.setItemId(1233L);
    req.setDiscountPrice(1000L);
    req.setFailProcess("close");
    req.setOpenLimit(1L);
    req.setAllowWhiteList(""用户1","用户2"");
    req.setAllowType("all");
    req.setGroupType(0L);
    req.setGoal(5L);
    req.setExpiration(3600L);
    req.setEndTime(StringUtils.parseDateTime("2020-09-10 10:00:00"));
    req.setStartTime(StringUtils.parseDateTime("2020-09-01 10:00:00"));
    req.setGroupActivityId(11111L);
    OpentradeGroupSyncResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <opentrade_group_sync_response>
        <result>
            <item_id>1234</item_id>
            <discount_price>1000</discount_price>
            <fail_process>close</fail_process>
            <open_limit>1</open_limit>
            <allow_white_list>
                <string>[&quot;用户1&quot;</string>
                <string>&quot;用户2&quot;]</string>
            </allow_white_list>
            <allow_type>all</allow_type>
            <group_type>0</group_type>
            <goal>5</goal>
            <expiration>3600</expiration>
            <end_time>2020-09-10 10:00:00</end_time>
            <start_time>2020-09-01 10:00:00</start_time>
            <group_activity_id>111111</group_activity_id>
        </result>
    </opentrade_group_sync_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

    返回
    顶部