文档中心 > API类目 > 淘宝客API

taobao.tbk.sf.group.manage.pull (淘宝客-服务商-组管理计划拉取)

淘宝客-服务商-组管理计划拉取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
pull_size Number 可选 20
  • 默认值:1
  • 一次拉取条数。最多支持50,默认1
    offset_code String 可选 6KNj7vzS6CG8PX7V5 计划消费点位。如传入则从该计划下一条开始拉取

    响应参数

    名称 类型 示例值 描述
    data EcoCapabilityBatchDTO 推送计划列表
    • └ remain_count
    • Number
    • 12
    • 剩余计划条数
    • opt_list
    • OperationDTO []
    • 操作列表
    • └ offset_code
    • String
    • 3D46122A_JQ
    • 计划点位(即任务ID)
    • agent_info
    • AgentInfo
    • 代理信息
    • └ account_id
    • String
    • 1345
    • 服务商账号ID
    • └ agent_id
    • String
    • 134252
    • 代理ID
    • └ biz_type
    • String
    • START_GROUP
    • 任务类型
    • └ biz_capability
    • String
    • START_GROUP
    • 功能类型
    • start_group_param
    • StartGroupParam
    • 建组任务参数
    • └ group_members
    • String []
    • 初始成员列表
    • mod_group_param
    • ModGroupParam
    • 修改组名称任务参数
    • └ group_id
    • String
    • 132
    • 需调整的组ID
    • └ group_name
    • String
    • GROUP-12
    • 需调整为什么名称
    is_success Boolean true 请求成功/失败
    biz_error_desc String 服务异常,请重试 异常描述。仅失败时有
    biz_error_code Number 15 异常代码。仅失败时有

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkSfGroupManagePullRequest req = new TbkSfGroupManagePullRequest();
    req.setPullSize(20L);
    req.setOffsetCode("6KNj7vzS6CG8PX7V5");
    TbkSfGroupManagePullResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_sf_group_manage_pull_response>
        <data>
            <remain_count>12</remain_count>
            <opt_list>
                <operation_d_t_o>
                    <offset_code>3D46122A_JQ</offset_code>
                    <agent_info>
                        <account_id>1345</account_id>
                        <agent_id>134252</agent_id>
                    </agent_info>
                    <biz_type>START_GROUP</biz_type>
                    <biz_capability>START_GROUP</biz_capability>
                    <start_group_param>
                    </start_group_param>
                    <mod_group_param>
                        <group_id>132</group_id>
                        <group_name>GROUP-12</group_name>
                    </mod_group_param>
                </operation_d_t_o>
            </opt_list>
        </data>
        <is_success>true</is_success>
        <biz_error_desc>服务异常,请重试</biz_error_desc>
        <biz_error_code>15</biz_error_code>
    </tbk_sf_group_manage_pull_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

    返回
    顶部