Описание
Этот объект представляет собой сообщение о завершении розыгрыша с публичными победителями.
| Поле | Тип | Описание |
|---|---|---|
| chat | Chat | Чат, создавший розыгрыш |
| giveaway_message_id | Integer | Идентификатор сообщения с розыгрышем в чате |
| winners_selection_date | Integer | Момент времени (Unix timestamp), когда были выбраны победители розыгрыша |
| winner_count | Integer | Общее количество победителей в розыгрыше |
| winners | Array of User | Список до 100 победителей розыгрыша |
| additional_chat_count | Integer | Необязательный. Количество других чатов, которые пользователь должен был присоединиться, чтобы иметь право на участие в розыгрыше |
| prize_star_count | Integer | Необязательный. Количество Telegram Stars, разделённых между победителями розыгрыша; только для розыгрышей Telegram Stars |
| premium_subscription_month_count | Integer | Необязательный. Количество месяцев, в течение которых будет активна подписка Telegram Premium, выигранная в розыгрыше; только для розыгрышей Telegram Premium |
| unclaimed_prize_count | Integer | Необязательный. Количество нераспределённых призов |
| only_new_members | True | Необязательный. True, если право на победу имели только пользователи, присоединившиеся к чатам после начала розыгрыша |
| was_refunded | True | Необязательный. True, если розыгрыш был отменён из-за возврата платежа |
| prize_description | String | Необязательный. Описание дополнительного приза розыгрыша |
Примеры
json
{
"chat": {
"id": -1001234567890,
"title": "Giveaway Channel",
"type": "channel"
},
"giveaway_message_id": 12345,
"winners_selection_date": 1698765432,
"winner_count": 5,
"winners": [
{
"id": 987654321,
"is_bot": false,
"first_name": "Alice",
"last_name": "Smith",
"username": "alice_smith"
},
{
"id": 876543210,
"is_bot": false,
"first_name": "Bob",
"username": "bob_winner"
}
],
"additional_chat_count": 2,
"prize_star_count": 5000,
"premium_subscription_month_count": 12,
"unclaimed_prize_count": 1,
"only_new_members": true,
"was_refunded": false,
"prize_description": "Exclusive VIP package"
}История изменений
- API 7.0. Добавлен объект GiveawayWinners
- API 7.10. Обновлен объект GiveawayWinners: Добавлено поле prize_star_count