修改频道身份组

修改频道身份组

修改频道身份组信息。

使用示例

import qqbot
token = qqbot.Token({appid}, {token})
api = qqbot.GuildRoleAPI(token, False)
result = api.update_guild_role(guild_id, role_id, role_info)

:::warning 注意需要使用的 token 对应的用户具备创建身份组权限。如果是机器人，要求被添加为管理员 :::

参数说明

字段名	必填	类型	描述
guild_id	是	string	频道 ID
role_id	是	string	身份组 ID
role_info	是	RoleUpdateInfo	频道身份组参数

RoleUpdateInfo

字段名	必填	类型	描述
name	是	string	名称
color	否	number	ARGB 的 HEX 十六进制颜色值转换后的十进制数值（例：4294927682）
hoist	否	number	在成员列表中单独展示: 0-否, 1-是

返回说明

字段名	类型	描述
guild_id	string	频道 ID
role_id	string	身份组 ID
role	GuildRole	频道身份组对象

GuildRole

字段名	类型	描述
id	string	身份组 ID
name	string	名称
color	number	ARGB 的 HEX 十六进制颜色值转换后的十进制数值（例：4294927682）
hoist	number	是否在成员列表中单独展示: 0-否, 1-是
number	number	人数
member_limit	number	成员上限

返回示例

data：

{
    "guild_id": "guild_id",
    "role_id": "role_id",
    "role": {
        "id": "role_id",
        "name": "Test Update Role",
        "color": 4278245297,
        "hoist": 0,
        "number": 0,
        "member_limit": 2000}
}