Skip to content

SetChatAdmins.md

Latest commit

 

History

History
89 lines (72 loc) · 5.28 KB

SetChatAdmins.md

File metadata and controls

89 lines (72 loc) · 5.28 KB

SetChatAdmins

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

Метод предназначен для назначения или обновления прав администраторов в группе.

Запрос {#request}

Поля запроса {#request-parameters}

Поле     Тип       Обязательный Описание                                      
chat_id integer Да           ID чата                                      
admins array Да Массив администраторов для назначения    
marker integer Нет           Маркер пагинации (если требуется API)        

Поля объекта chat_admin {#ChatAdmin}

Поле     Тип       Обязательный Описание                                      
user_id integer Да Идентификатор пользователя-участника чата, который назначается администратором
Максимум — 50 администраторов в чате
permissions array Да Перечень прав доступа пользователя. Возможные значения:
read_all_messages - Читать все сообщения. Это право важно при назначении ботов: без него бот не будет получать апдейты (вебхуки) в групповом чате
add_remove_members - Добавлять/удалять участников
add_admins - Добавлять администраторов
change_chat_info - Изменять информацию о чате
pin_message - Закреплять сообщения
write - Писать сообщения
can_call - Совершать звонки
edit_link - Изменять ссылку на чат
post_edit_delete_message - Публиковать, редактировать и удалять сообщения
edit_message - Редактировать сообщения
delete_message - Удалять сообщения
alias string Нет Заголовок, который будет показан на клиенте. Если пользователь администратор или владелец и ему не установлено это название, то поле не передаётся, клиенты на своей стороне подменят на "владелец" или "админ"

Пример запроса {#request-example}

Синхронный запрос:

bot.chats.SetChatAdmins(SetChatAdminsReq(
    chat_id=123456789,
    admins={
        {
            user_id=55555, 
            permissions=["read_all_messages", "write"]
        },
        {
            user_id=66666, 
            permissions=["read_all_messages", "post_edit_delete_message"]
        },
    },
))

Асинхронный запрос:

await bot.chats.SetChatAdminsAsync(SetChatAdminsReq(
    chat_id=123456789,
    admins={
        {
            user_id=55555, 
            permissions=["read_all_messages", "write"]
        },
        {
            user_id=66666, 
            permissions=["read_all_messages", "post_edit_delete_message"]
        },
    },
))

Ответ {#response}

Поля ответа {#response-parameters}

Поле       Тип         Описание                                                
success boolean true, если запрос был успешным,false — в противном случае 
message string   Объяснительное сообщение, если результат не был успешным

Пример тела ответа {#response-example-body}

{
    "success": true
}