创建频道公告

接口

POST /guilds/{guild_id}/announces

功能描述

用于创建频道全局公告，公告类型分为 消息类型的频道公告 和 推荐子频道类型的频道公告 。

• 当请求参数 message_id 有值时，优先创建消息类型的频道公告， 消息类型的频道公告只能创建成员公告类型的频道公告。
• 创建推荐子频道类型的频道全局公告请将 message_id 设置为空，并设置对应的 announces_type 和 recommend_channels 请求参数，会一次全部替换推荐子频道公司。
• 推荐子频道和消息类型全局公告不能同时存在，会互相顶替设置。
• 同频道内推荐子频道最多只能创建 3 条。
• 只有子频道权限为全体成员可见才可设置为推荐子频道。
• 删除推荐子频道类型的频道公告请使用 删除频道公告,并将 message_id 设置为 all。

Content-Type

application/json

参数

字段名	类型	描述
message_id	string	选填，消息 id，message_id 有值则优选将某条消息设置为成员公告
channel_id	string	选填，子频道 id，message_id 有值则为必填。
announces_type	uint32	选填，公告类别 0:成员公告，1:欢迎公告，默认为成员公告
recommend_channels	RecommendChannel 数组	选填，推荐子频道列表，会一次全部替换推荐子频道列表

返回

返回Announces 对象。

错误码

详见错误码。

示例

创建频道公告请求数据包

{
  "channel_id": "123456",
  "message_id": "xxxxxx"
}

创建频道公告响应数据包

{
  "guild_id": "xxxxxx",
  "channel_id": "123456",
  "message_id": "xxxxxx",
  "announces_type": 0,
  "recommend_channels":[]
}

创建推荐子频道类型的频道公告请求数据包

{
 "announces_type": 1,
 "recommend_channels": [{
  "channel_id": "xxxx",
  "introduce": "推荐语"
 }, {
  "channel_id": "xxxx",
  "introduce": "推荐语"
 }]
}

创建推荐子频道类型的频道公告响应数据包

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