Botpy-Docs

修改子频道身份组权限

修改子频道身份组的权限。

使用示例

import botpy
from botpy import Permission
from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await self.api.update_channel_role_permissions(
            channel_id="xxxx",
            role_id="xxxx",
            add=Permission(speak_permission=True), # 添加可发言子频道
            remove=Permission(speak_permission=False), # 移除可发言子频道
        )

intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid={appid}, token={token})

注意

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 本接口不支持修改可管理子频道权限。

参数说明

字段名必填类型描述
channel_id是string子频道 ID
role_id是string身份组 ID
add是string字符串形式的十进制数表示赋予用户的权限，参考Permissions
remove是string字符串形式的十进制数表示删除用户的权限，参考Permissions

Permissions

权限是 QQ 频道管理频道成员的一种方式，管理员可以对不同的人、不同的子频道设置特定的权限。用户的权限包括个人权限和身份组权限两部分，最终生效是取两种权限的并集。

权限在服务端使用十六进制方式描述，现有权限类型如下：

权限值描述
可查看子频道0x0000000001(1 << 0)支持指定成员可见类型，支持身份组可见类型
可管理子频道0x0000000002(1 << 1)创建者、管理员、子频道管理员都具有此权限
可发言子频道0x0000000004(1 << 2)支持指定成员发言类型，支持身份组发言类型

提示

对位运算和移位操作符 不熟悉的可参考相关文档open in new window。 以上述可发言子频道权限为例，操作数1经1<<2移位操作后，对应的二进制数为100，对应的16进制数为0x4。同理如果要表示权限可发言 + 可查看，将两种权限做加法即可，即：0x0000000002 +0x0000000004=0x0000000006。

返回示例

data：

True