Botpy-Docs

修改子频道

修改某个子频道的信息。

注意

  • 公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
  • 注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

使用示例

import botpy
from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        """
        name	            string	子频道名
        position	        int	    排序
        parent_id	        string	分组 id
        private_type	    int	    子频道私密类型 PrivateType
        speak_permission	int	    子频道发言权限 SpeakPermission
        """
        await self.api.update_channel(channel_id="xxxx")

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

注意

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 修改成功后，会触发子频道更新事件

参数说明

字段名必填类型描述
channelId是string子频道 ID
channel是Channel子频道对象

Channel

字段名类型描述
namestring子频道名
typenumber子频道类型 ChannelType
positionnumber排序，必填，而且不能够和其他子频道的值重复
parent_idstring分组 ID

ChannelType

值描述
0文字子频道
1保留，不可用
2语音子频道
3保留，不可用
4子频道分组
10005直播子频道
10006应用子频道
10007论坛子频道

注：由于 QQ 频道还在持续的迭代中，经常会有新的子频道类型增加，文档更新不一定及时，开发者识别 ChannelType 时，请注意相关的未知 ID 的处理。

返回说明

字段参见 ChannelRes。

ChannelRes

字段名类型描述
idstring子频道 ID
guild_idstring频道 ID
namestring子频道名
typenumber子频道类型 ChannelType
sub_typenumber子频道子类型 ChannelSubType
positionnumber排序，必填，而且不能够和其他子频道的值重复
parent_idstring分组 ID
owner_idstring创建人 ID

ChannelSubType

值描述
0闲聊
1公告
2攻略
3开黑

返回示例

data：

{
  "id": "2186875",
  "guild_id": "2020131797974366736",
  "name": "update_channel",
  "type": 0,
  "position": 22,
  "parent_id": "1128421",
  "owner_id": null,
  "sub_type": 0
}