创建子频道

创建一个子频道。

使用示例

token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
channel, channelError := api.PostChannel(ctx, guildId, &dto.ChannelValueObject{
  Name:    "子频道名",
  Type:    dto.ChannelTypeText,
  SubType: dto.ChannelSubTypeChat,
})
if channelError != nil {
  log.Fatalln("调用 PostChannel 接口失败, err = ", channelError)
}

::: warning 注意

• 要求操作人具有管理频道的权限，如果是机器人，则需要将机器人设置为管理员。
• 创建成功后，返回创建成功的子频道对象，同时会触发一个频道创建的事件通知。
• 目前不支持创建的子频道类型
  • 子频道分组
  • 私密子频道

:::

参数说明

ChannelValueObject

ChannelType

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

ChannelSubType

返回说明

返回 Channel 对象。

Channel

SpeakPermissionType

ChannelPrivateType

返回示例

data：

{
  "id": "channel_id",
  "guild_id": "guild_id",
  "name": "channel_test",
  "type": 1,
  "position": 1640240055,
  "owner_id": "2854198244",
  "sub_type": 0
}