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

Add_admin_chat

maxapi.methods.add_admin_chat.AddAdminChat(bot, chat_id, admins, marker=None)

Bases: BaseConnection

Класс для назначения администраторов чата или канала через API.

https://dev.max.ru/docs-api/methods/POST/chats/-chatId-/members/admins

Attributes:

Name Type Description
bot

Экземпляр бота, через который выполняется запрос.
chat_id

Идентификатор чата или канала.
admins

Список администраторов для назначения.
marker

Устаревший параметр, больше не отправляется в API.
Source code in maxapi/methods/add_admin_chat.py 
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
def __init__(
    self,
    bot: "Bot",
    chat_id: int,
    admins: list[ChatAdmin],
    marker: int | None = None,
):
    if marker is not None:
        warnings.warn(
            "Параметр marker в AddAdminChat устарел и "
            "игнорируется: POST /chats/{chatId}/members/admins "
            "больше не поддерживает marker.",
            DeprecationWarning,
            stacklevel=2,
        )

    super().__init__()
    self.bot = bot
    self.chat_id = chat_id
    self.admins = admins
    self.marker = marker

fetch() async

Выполняет HTTP POST запрос для назначения администраторов.

Формирует JSON с данными администраторов и отправляет запрос на соответствующий API-эндпоинт.

Returns:

Name Type Description
AddedListAdminChat AddedListAdminChat

Результат операции с информацией об успешности.
Source code in maxapi/methods/add_admin_chat.py 
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
async def fetch(self) -> AddedListAdminChat:
    """
    Выполняет HTTP POST запрос для назначения администраторов.

    Формирует JSON с данными администраторов и отправляет запрос на
    соответствующий API-эндпоинт.

    Returns:
        AddedListAdminChat: Результат операции с информацией
            об успешности.
    """

    bot = self._ensure_bot()

    json: dict[str, Any] = {}

    json["admins"] = [admin.model_dump() for admin in self.admins]

    response = await super().request(
        method=HTTPMethod.POST,
        path=ApiPath.CHATS.value
        + "/"
        + str(self.chat_id)
        + ApiPath.MEMBERS
        + ApiPath.ADMINS,
        model=AddedListAdminChat,
        params=bot.params,
        json=json,
    )

    return cast(AddedListAdminChat, response)