Skip to content

set_group_admin ​

设置或取消群聊管理员。

此接口在已认证的服务连接中调用,账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

适用协议

Android(手机 / 平板)/ Linux QQ。

调用方式 ​

向已认证的 WebSocket 连接发送:

json
{
  "type": "action",
  "id": "example-1",
  "action": "set_group_admin",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "user_id": 234567890,
    "set_admin": true
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数 ​

参数类型必填说明
self_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
group_idinteger是目标群号
user_idinteger是目标 QQ 号
set_adminboolean是true 设置管理员,false 取消

返回值 ​

以下为成功响应的 data,错误通过 ok: false 与 error 返回。

字段类型说明
group_idinteger目标群号
user_idinteger目标 QQ 号
set_adminbooleantrue 设置管理员,false 取消

萌卡 · 自托管 QQ 机器人框架