修改频道身份组

修改频道身份组信息。

使用示例

token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()

roles, err := api.PatchRole(ctx, guildId, dto.RoleID(roleId), &dto.Role{
    Name: "新身份组",
})
if err != nil {
    log.Fatalln("调用 PatchRole 接口失败, err = ", err)
}

注意

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

参数说明

字段名	必填	类型	描述
guildId	是	string	频道 ID
roleId	是	string	身份组 ID
Role	是	Role	频道身份组参数

Role

字段名	必填	类型	描述
ID	否	string	身份组 ID
Name	是	string	名称
Color	否	uint32	ARGB 的 HEX 十六进制颜色值转换后的十进制数值（例：4294927682）
Hoist	否	uint32	是否在成员列表中单独展示: 0-否, 1-是
MemberCount	否	uint32	人数
MemberLimit	否	uint32	成员上限

返回说明

字段名	类型	描述
GuildID	string	频道 ID
RoleID	string	身份组 ID
Role	Role	频道身份组对象

返回示例

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}
}