体验 App SDK 中心 API 中心常见问题代码市场

中文

即时通讯

产品

云通讯产品

实时音视频 Hot
实时语音
畅直播 Hot
即时通讯

AIGC

扩展服务

低代码互动产品

RoomKit
Go 课堂

云市场

标准 AI 产品

数美内容审核 New
大饼 AI 变声 New
实时传译 New

解决方案

AIGC

虚拟直播
虚拟语聊
虚拟小窝

社交娱乐

电商直播

电商直播

在线教育

医疗健康

远程医疗

互动游戏

游戏直播
游戏语音

协同办公

语音通话
视频通话
视频会议

物联网

娃娃机

iOS : Objective-C
- Objective-C
Android
macOS
Windows
Web
小程序
Flutter
Unity3D
uni-app
React Native

文档中心
即时通讯
服务端 API
群组相关
转让群主

转让群主

更新时间：2024-02-27 17:39

描述

通过该接口可以将群主身份转移给群内其他成员。

转让成功后，群内成员通过以下 ZIM SDK 的回调接口，收到相关通知：

iOS	Android	macOS	Windows	Web
groupMemberInfoUpdated	onGroupMemberInfoUpdated	groupMemberInfoUpdated	onGroupMemberInfoUpdated	groupMemberInfoUpdated
小程序	Flutter	Unity3D	uni-app	React Native
groupMemberInfoUpdated	onGroupMemberInfoUpdated	OnGroupMemberInfoUpdated	groupMemberInfoUpdated	groupMemberInfoUpdated

接口原型

请求方法：GET
请求地址： https://zim-api.zego.im/?Action=TransferGroupOwner
传输协议：HTTPS
调用频率限制：1 次/秒，群级别限制。如需调整，请联系 ZEGO 技术支持。

请求参数

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

参数	类型	是否必选	描述
FromUserId	String	是	操作者用户 ID。
GroupId	String	是	群 ID。
NewOwner	String	是	新群主（接收转让的用户） ID，需为群内用户。

FromUserId、GroupId、NewOwner 仅支持数字，英文字符和 '!'，'#'，'$'，'%'，'&'，'('，')'，'+'，''，':'，';'，'<'，'='，'.'，'>'，'?'，'@'，'['，']'，'^'，'_'，'{'，'}'，'|'，'~'。

请求示例

https://zim-api.zego.im/?Action=TransferGroupOwner
&FromUserId=zego_user&GroupId=groupid&NewOwner=newowner
&<公共请求参数>

响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	操作结果描述。
RequestId	String	请求 ID。

响应示例

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

返回码

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

返回码	说明	处理建议
660000002	参数错误。	请检查请求参数。
660300006	超出调用频率限制。	请稍后再试。
660500002	操作者用户未注册。	请先注册该用户。
660600001	群不存在。	请检查 GroupID 是否正确。
660600024	接受转让的用户不在群内。	请参考添加群成员将该用户拉进群内。

本篇目录