接口 AnnouncesApi
public interface AnnouncesApi
公告消息Api
-
方法概要
修饰符和类型方法说明createGuildAnnounces(String bot_id, String guild_id, String message_id, String channel_id) 创建频道公告 用于创建频道全局公告,公告类型分为 消息类型的频道公告 和 推荐子频道类型的频道公告 。createGuildRecommend_Channels(String bot_id, String guild_id, Integer announces_type, List<RecommendChannel> recommendChannels) 创建频道推荐子频道列表deleteAnnouncesByGuildId(String bot_id, String guild_id, String message_id) 删除频道公告 用于删除频道 guild_id 下指定 message_id 的全局公告。
-
方法详细资料
-
createGuildAnnounces
Tuple<Announces,String> createGuildAnnounces(String bot_id, String guild_id, String message_id, String channel_id) 创建频道公告 用于创建频道全局公告,公告类型分为 消息类型的频道公告 和 推荐子频道类型的频道公告 。 当请求参数 message_id 有值时,优先创建消息类型的频道公告, 消息类型的频道公告只能创建成员公告类型的频道公告。 创建推荐子频道类型的频道全局公告请将 message_id 设置为空,并设置对应的 announces_type 和 recommend_channels 请求参数,会一次全部替换推荐子频道公司。 推荐子频道和消息类型全局公告不能同时存在,会互相顶替设置。 同频道内推荐子频道最多只能创建 3 条。 只有子频道权限为全体成员可见才可设置为推荐子频道。 删除推荐子频道类型的频道公告请使用 删除频道公告,并将 message_id 设置为 all。- 参数:
bot_id- 传入机器人IDguild_id- 频道IDmessage_id- 消息IDchannel_id- 子频道ID- 返回:
- 返回公告对象
-
deleteAnnouncesByGuildId
删除频道公告 用于删除频道 guild_id 下指定 message_id 的全局公告。 message_id 有值时,会校验 message_id 合法性,若不校验校验 message_id,请将 message_id 设置为 all- 参数:
bot_id- 传入机器人IDguild_id- 频道IDmessage_id- 消息ID- 返回:
- 返回删除结果
-
createGuildRecommend_Channels
Tuple<Announces,String> createGuildRecommend_Channels(String bot_id, String guild_id, Integer announces_type, List<RecommendChannel> recommendChannels) 创建频道推荐子频道列表- 参数:
bot_id- 传入机器人IDguild_id- 频道IDannounces_type- 公告类型recommendChannels- 机器人推荐列表- 返回:
- 返回公告对象
-