Skip to content

Latest commit

 

History

History
73 lines (58 loc) · 4.91 KB

File metadata and controls

73 lines (58 loc) · 4.91 KB

SetChatAdmins

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

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

Запрос {#request}

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

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

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

Поле     Тип       Обязательный Описание                                      
UserID 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}

response, err := bot.Chats.SetChatAdmins(
    context.Background(), 
    &models.SetChatAdminsReq{
        ChatID: 123456789,
        Admins: []models.ChatAdmin{
            {
                UserID: 55555, 
                Permissions: "read_all_messages", "write"
            },
            {
                UserID: 66666, 
                Permissions: "read_all_messages", "post_edit_delete_message"
            },
        },
    }
)

Ответ {#response}

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

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

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

{
    "success": true
}