获取子频道身份组权限

获取指定子频道身份组的权限。

使用示例

import botpy
from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await self.api.get_channel_role_permissions(channel_id="xxxx", role_id="xxxx")

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

返回说明

返回 ChannelPermissions 对象。

ChannelPermissions

字段名	类型	描述
channel_id	string	子频道 ID
role_id	string	身份组 ID，
permissions	string	用户拥有的子频道权限，参考 Permissions

Permissions

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

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

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

提示

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

SDK中权限用十进制字符串描述，以下面返回示例为例，permissions是'1'，表示拥有可查看子频道(1)权限。

返回示例

data：

{
  "channel_id": 'CHANNEL_ID',
  "role_id": 'ROLE_ID',
  "permissions": '1'
}