注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 店铺会员管理API

taobao.crm.group.append (将一个分组添加到另外一个分组)

将某分组下的所有会员添加到另一个分组,注:1.该操作为异步任务,建议先调用taobao.crm.grouptask.check 确保涉及分组上没有任务;2.若分组下某会员分组数超最大限额,则该会员不会被添加到新分组,同时不影响其余会员添加分组,接口调用依然返回成功。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
from_group_id Number 必须 1234
  • 最小值:1
  • 最大长度:19
  • 添加的来源分组
    to_group_id Number 必须 5678
  • 最小值:1
  • 最大长度:19
  • 添加的目标分组

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 异步任务请求成功,添加任务是否完成通过taobao.crm.grouptask.check检测

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CrmGroupAppendRequest req = new CrmGroupAppendRequest();
    req.setFromGroupId(1234L);
    req.setToGroupId(5678L);
    CrmGroupAppendResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <crm_group_append_response>
        <is_success>true</is_success>
    </crm_group_append_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.parameters-mismatch:seller_id-and-from_group_id-and-to_group_id 源分组和目标分组的id值相同 目标分组和源分组的ID不能一样
    isv.groupmove-service-error 分组上有批量操作 首先调用taobao.crm.grouptask.check检测该属性上是否有批量操作
    isv.invalid-parameter:from_group_id 源分组不存在 通过taobao.crm.group.get查询到相应group_id再进行添加
    isv.invalid-parameter:to_group_id 目标分组不存在 通过taobao.crm.group.get查询到相应group_id再进行添加
    isp.crmtop-service-unavailable 当前服务不可用 请稍侯再试
    isv.invalid-permission 当前的登录权限不够 检查帐号权限

    API工具

    如何获得此API

    FAQ

    返回
    顶部