创建频道身份组
创建一个频道身份组。
使用示例
import qqbot
token = qqbot.Token({appid}, {token})
api = qqbot.GuildRoleAPI(token, False)
result = api.create_guild_role(guild_id, role_info)
::: warning 注意
需要使用的 token 对应的用户具备创建身份组权限。如果是机器人,要求被添加为管理员。
:::
参数说明
字段名 |
必填 |
类型 |
描述 |
guild_id |
是 |
string |
频道 ID |
role_info |
是 |
RoleUpdateInfo |
频道身份组参数 |
RoleUpdateInfo
字段名 |
必填 |
类型 |
描述 |
name |
是 |
string |
名称 |
color |
否 |
number |
ARGB 的 HEX 十六进制颜色值转换后的十进制数值(例:4294927682) |
hoist |
否 |
number |
在成员列表中单独展示: 0-否, 1-是 |
返回说明
字段名 |
类型 |
描述 |
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 |
成员上限 |