Перейти к содержанию

Pin_message

maxapi.methods.pin_message.PinMessage(bot, chat_id, message_id, *, notify=None)

Bases: BaseConnection

Класс для закрепления сообщения в чате.

https://dev.max.ru/docs-api/methods/PUT/chats/-chatId-/pin

Attributes:

Name Type Description
bot

Экземпляр бота для выполнения запроса.
chat_id

Идентификатор чата, в котором закрепляется сообщение.
message_id

Идентификатор сообщения для закрепления.
notify

Отправлять ли уведомление о закреплении (по умолчанию True).
Source code in maxapi/methods/pin_message.py 
27
28
29
30
31
32
33
34
35
36
37
38
39
def __init__(
    self,
    bot: "Bot",
    chat_id: int,
    message_id: str,
    *,
    notify: bool | None = None,
):
    super().__init__()
    self.bot = bot
    self.chat_id = chat_id
    self.message_id = message_id
    self.notify = notify

fetch() async

Выполняет PUT-запрос для закрепления сообщения в чате.

Формирует тело запроса с ID сообщения и флагом уведомления.

Returns:

Name Type Description
PinnedMessage PinnedMessage

Объект с информацией о закреплённом сообщении.
Source code in maxapi/methods/pin_message.py 
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
async def fetch(self) -> PinnedMessage:
    """
    Выполняет PUT-запрос для закрепления сообщения в чате.

    Формирует тело запроса с ID сообщения и флагом уведомления.

    Returns:
        PinnedMessage: Объект с информацией о закреплённом сообщении.
    """

    bot = self._ensure_bot()

    json: dict[str, Any] = {}

    json["message_id"] = self.message_id
    json["notify"] = self.notify

    response = await super().request(
        method=HTTPMethod.PUT,
        path=ApiPath.CHATS + "/" + str(self.chat_id) + ApiPath.PIN,
        model=PinnedMessage,
        params=bot.params,
        json=json,
    )

    return cast(PinnedMessage, response)