创建频道公告推荐子频道

用于将指定子频道设置为当前频道的推荐子频道，并以全局公告形式展示。

::: warning 注意

• 同频道内推荐子频道最多只能创建 3 条。
• 推荐子频道和全局公告不能同时存在，会互相顶替设置。
• 只有子频道权限为全体成员可见才可设置为推荐子频道。
• 删除频道公告推荐子频道请使用 删除频道公告,并将 messageId 设置为 all。

:::

使用示例

token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
announces, err := api.CreateGuildAnnounces(ctx, guildId, &dto.GuildAnnouncesToCreate{
  RecommendChannels: []dto.RecommendChannel{
    {
      ChannelID: channelId,
      Introduce: "推荐",
    },
  },
})
if err != nil {
  log.Fatalln("调用 CreateGuildAnnounces 接口失败, err = ", err)
}

参数说明

GuildAnnouncesToCreate

RecommendChannel

返回说明

返回 Announces 对象。

Announces

返回示例

data：

{
  "guild_id": "xxxxxx",
  "channel_id": "xxxxx",
  "message_id": "",
  "announces_type": 0,
  "recommend_channels": [
    {
      "channel_id": "xxxx",
      "introduce": "推荐语"
    },
    {
      "channel_id": "xxxx",
      "introduce": "推荐语"
    }
  ]
}