创建精华消息

用于将messageId添加为子频道 channelId 内的精华消息。

::: warning 注意

• 精华消息在一个子频道内最多只能创建 20 条。
• 只有可见的消息才能被设置为精华消息。
• 接口返回对象中 message_ids 为当前请求后子频道内所有精华消息 message_id 数组。

:::

使用示例

sync

import qqbot
token = qqbot.Token({appid}, {token})
def demo():
    api = qqbot.PinsAPI(token, IS_SANDBOX)
    result = api.put_pin(channel_id, message_id)

async

import qqbot
token = qqbot.Token({appid}, {token})
async def demo():
    api = qqbot.AsyncPinsAPI(token, IS_SANDBOX)
    result = await api.put_pin(channel_id, message_id)

参数说明

返回说明

返回 PinsMessage 对象。

PinsMessage

返回示例

data：

{
  "guild_id": "xxxxxx",
  "channel_id": "xxxxxx",
  "message_ids": ["xxxxx"]
}