# 删除子频道 v1.0.0

移除一个子频道。

注意

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

# 使用示例

async function demo() {
  let { data } = await client.channelApi.deleteChannel(channelId);
}
1
2
3

注意

  • 要求操作人具有管理频道的权限,如果是机器人,则需要将机器人设置为管理员。
  • 创建成功后,返回创建成功的子频道对象,同时会触发一个频道创建的事件通知。
  • 子频道的删除是无法撤回的,一旦删除,将无法恢复。

# 参数说明

字段名 必填 类型 描述
channelId string 子频道 ID

# 返回说明

返回一个 ChannelRes 对象。

# ChannelRes

字段名 类型 描述
id string 子频道 ID
guild_id string 频道 ID
name string 子频道名
type number 子频道类型 ChannelType

# ChannelType

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

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

# 返回示例

data

{
    id: 'CHENNAL_ID',
    type: 3,
    name: 'ostwindli话题讨论',
    guild_id: 'GUILD_ID'
  }
1
2
3
4
5
6
手机QQ扫码
开发者社区
加入官方频道开发者社区