创建精华消息
用于将messageId
添加为子频道 channelId
内的精华消息。
::: warning 注意
- 精华消息在一个子频道内最多只能创建
20
条。 - 只有可见的消息才能被设置为精华消息。
- 接口返回对象中
message_ids
为当前请求后子频道内所有精华消息message_id
数组。
:::
使用示例
token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
pinsMessage, err := api.AddPins(ctx, channelId, msgId)
if err != nil {
log.Fatalln("调用 AddPins 接口失败, err = ", err)
}
参数说明
字段名 | 必填 | 类型 | 描述 |
---|---|---|---|
channelId | 是 | string | 子频道 ID |
msgId | 是 | string | 消息 ID |
返回说明
返回 PinsMessage 对象。
PinsMessage
字段名 | 类型 | 描述 |
---|---|---|
GuildID | string | 频道 ID |
ChannelID | string | 子频道 ID |
MessageIDs | string[] | 消息 ID |
返回示例
data
:
{
"guild_id": "xxxxxx",
"channel_id": "xxxxxx",
"message_ids": ["xxxxx"]
}