Skip to content

set_group_name

修改群名。v2.0.6 新增;不能只替换 SDK 后调用 v2.0.5 服务。Android 和 Linux QQ 均使用明确的账号协议选择器,Android/Linux 已在双账号、跨节点及三 WS 的列明操作场景中验证,不代表所有外部客户端模板均可用。

js
await api.forProtocol('android').set_group_name({
  self_id: 2082083, group_id: 1108676556, group_name: '测试群'
})
对象参数类型必填说明
self_idnumber已登录账号
group_idnumber要管理的群
group_namestring非空 UTF-8 文本,最多 60 字节

直接发送 WS action 时还必须传 client_type: android | linuxqq。账号需要具备 QQ 服务端允许的群管理权限。

成功返回 {success: true, group_id, group_name, read_back_verified: true}。只有提交后读回群名相符才返回成功。读回失败不代表修改未生效,请先查询确认,不要自动重复操作。参数错误、离线、网络超时或原生拒绝均返回 action 错误。

可搭配 get_group_listgroup_name_changed;事件需声明 group_event。操作成功和真实事件投递分别验收,不通过 API 返回值合成事件。

萌卡 NT · 连接想法,也连接你我。