文档中心 > API类目 > 子账号管理

taobao.sellercenter.role.add (子账号角色的新增(指定卖家))

给指定的卖家创建新的子账号角色
如果需要授权的权限点有下级权限点或上级权限点,把该权限点的父权限点和该权限点的所有子权限都一并做赋权操作,并递归处理
例如:权限点列表如下
code=sell 宝贝管理
---------|code=sm 店铺管理
---------|---------|code=sm-design 如店铺装修
---------|---------|---------|code=sm-tbd-visit内店装修入口
---------|---------|---------|code=sm-tbd-publish内店装修发布
---------|---------|code=phone 手机淘宝店铺
调用改接口给code=sm-design店铺装修赋权时,同时会将下列权限点都赋予默认角色
code=sell 宝贝管理
---------|code=sm 店铺管理
---------|---------|code=sm-design 如店铺装修
---------|---------|---------|code=sm-tbd-visit内店装修入口
---------|---------|---------|code=sm-tbd-publish内店装修发布

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 zhangsan
  • 最大长度:500
  • 表示卖家昵称
    name String 必须 发货员
  • 最大长度:20
  • 角色名
    description String 可选 发货的管理员
  • 最大长度:20
  • 角色描述
    permission_codes String [] 可选 sm,ecrm
  • 最大列表长度:2000
  • 需要授权的权限点permission_code列表,以","分割.其code值可以通过调用taobao.sellercenter.user.permissions.get返回,其中permission.is_authorize=1的权限点可以通过本接口授权给对应角色。

    响应参数

    名称 类型 示例值 描述
    role Role 子账号角色
    • └ role_id
    • Number
    • 123456
    • 角色id
    • └ description
    • String
    • 发货管理员
    • 角色描述
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • permissions
    • Permission []
    • 所拥有权限
    • └ permission_code
    • String
    • tgj
    • 注册到权限中心的code值
    • └ is_authorize
    • Number
    • 1
    • 1 :允许授权 2:不允许授权 6:不允许授权但默认已有权限
    • └ permission_name
    • String
    • 宝贝管理
    • 权限名称
    • └ parent_code
    • String
    • zhangsan
    • 父权限code
    • └ create_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ seller_id
    • Number
    • 123456
    • 卖家Id
    • └ role_name
    • String
    • 发货员
    • 角色名

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SellercenterRoleAddRequest req = new SellercenterRoleAddRequest();
    req.setNick("zhangsan");
    req.setName("发货员");
    req.setDescription("发货的管理员");
    req.setPermissionCodes("sm,ecrm");
    SellercenterRoleAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <sellercenter_role_add_response>
        <role>
            <role_id>123456</role_id>
            <description>发货管理员</description>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <permissions>
                <permission>
                    <permission_code>tgj</permission_code>
                    <is_authorize>1</is_authorize>
                    <permission_name>宝贝管理</permission_name>
                    <parent_code>zhangsan</parent_code>
                </permission>
            </permissions>
            <create_time>2000-01-01 00:00:00</create_time>
            <seller_id>123456</seller_id>
            <role_name>发货员</role_name>
        </role>
    </sellercenter_role_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.missing-parameter:nick 缺少必要的参数nick 前端校验
    isv.missing-parameter:name 缺少必要的参数角色名 name 前端校验
    isv.mmp-add-role-service-error:system_error 系统错误 系统错误,联系小二
    isv.invalid-permission:no_permission 您无权查询或操作此用户的角色信息或者您没有权限管理的权限 用对应的有权限管理的账号登陆
    isv.nick-not-exist:user_do 提供的昵称不合法或系统中不存在该昵称的主账户 提供正确的nick
    isv.role-exists:role_exists 角色已存在 角色名不能重复
    isv.role-num-exceed:role_num_exceed 角色数量超过限制 无法继续创建角色
    isv.invalid-parameter:name 角色名不能超过20个字符 提供正确的角色名
    isv.invalid-parameter:description 角色描述不能超过20个字符 提供正确的角色描述
    isv.invalid-parameter:peimission_codes 传入的Permission_codes里面包含无效code 提供正确的code列表
    isv.invalid-parameter:peimission_codes2 传入的Permission_codes里面有他的主账号不拥有的权限或者不允许授权的权限 提供正确的code列表

    API工具

    如何获得此API

    FAQ

    返回
    顶部