设置群成员角色

描述

调用此接口，可以为群成员设置在群内的角色。

ZIM SDK 默认支持将用户设置为群主、管理员、普通成员。在群组中，群主拥有所有客户端权限，可以实现所有群组功能。管理员拥有大部分客户端权限。普通成员拥有的客户端权限最少，具体如下表所示：

除此之外，还可以自定义群角色，但该角色拥有的客户端权限与普通成员一致。

设置成功后，群内成员通过以下 ZIM 回调收到通知：

接口原型

• 请求方法：GET
• 请求地址：https://zim-api.zego.im/?Action=SetGroupMemberRole
• 传输协议：HTTPS
• 调用频率限制：20 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 - 公共请求参数。

请求示例

https://zim-api.zego.im/?Action=SetGroupMemberRole
&<公共请求参数>
&FromUserId=zego
&GroupId=group
&ToUserId=zego2
&Role=3

响应参数

响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "343649807833778782"
}

返回码

以下仅列出了接口业务逻辑相关的返回码，完整返回码请参考 全局返回码。