修改子频道权限

修改子频道权限。

使用示例

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_user_permissions(channel_id="xxxx", user_id="xxxx")

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

注意

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

参数说明

字段名	必填	类型	描述
channel_id	是	string	子频道 ID
user_id	是	string	用户 ID
channel_permissions	是	UpdatePermission	权限参数

UpdatePermission

参数包括add和remove两个字段，分别表示授予的权限以及删除的权限。要授予用户权限即把add对应位置1，删除用户权限即把remove对应位置1。当两个字段同一位都为1，表现为删除权限。

字段名	类型	描述
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。

SDK中权限用十进制字符串描述，可参考如下提示：

返回说明

返回是否更新成功

返回示例

data：

True

# 修改子频道权限

# 使用示例

# 参数说明

# UpdatePermission

# Permissions

# 返回说明