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

taobao.sellercenter.roles.get (获取指定卖家的角色列表)

获取指定卖家的角色列表,只能获取属于登陆者自己的信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 zhangsan
  • 最大长度:500
  • 卖家昵称(只允许查询自己的信息:当前登陆者)

    响应参数

    名称 类型 示例值 描述
    roles Role [] 卖家子账号角色列表。
    返回对象为 role数据对象中的role_id,role_name,description,seller_id,create_time,modified_time。不包含permissions(权限点)
    • └ role_id
    • Number
    • 123456
    • 角色id
    • └ description
    • String
    • 发货管理员
    • 角色描述
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ 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);
    SellercenterRolesGetRequest req = new SellercenterRolesGetRequest();
    req.setNick("zhangsan");
    SellercenterRolesGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <sellercenter_roles_get_response>
        <roles>
            <role>
                <role_id>123456</role_id>
                <description>发货管理员</description>
                <modified_time>2000-01-01 00:00:00</modified_time>
                <create_time>2000-01-01 00:00:00</create_time>
                <seller_id>123456</seller_id>
                <role_name>发货员</role_name>
            </role>
        </roles>
    </sellercenter_roles_get_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 必填参数nick为空;请确保传入的必选参数不为空,请对照参数表
    isv.mmp-query-subuser-roles-service-error:system_error 系统异常 系统异常
    isv.invalid-permission:no_permission 您无权查询或操作此用户的角色信息或者您没有权限管理的权限 用对应的有权限管理的账号登陆
    isv.nick-not-exist:user_do 提供的昵称不合法或系统中不存在该昵称的主账户 提供正确的nick

    API工具

    如何获得此API

    FAQ

    返回
    顶部