Описание
Этот объект представляет собой сообщение о запланированном розыгрыше.
| Поле | Тип | Описание |
|---|---|---|
| chats | Массив объектов Chat | Список чатов, в которые пользователь должен вступить для участия в розыгрыше |
| winners_selection_date | Integer | Момент времени (Unix timestamp), когда будут выбраны победители розыгрыша |
| winner_count | Integer | Количество пользователей, которые должны быть выбраны в качестве победителей розыгрыша |
| only_new_members | True | Необязательное. True, если право на победу имеют только пользователи, вступившие в чаты после начала розыгрыша |
| has_public_winners | True | Необязательное. True, если список победителей розыгрыша будет виден всем |
| prize_description | String | Необязательное. Описание дополнительного приза розыгрыша |
| country_codes | Массив String | Необязательное. Список двухбуквенных кодов стран ISO 3166-1 alpha-2, указывающих страны, из которых должны быть пользователи, имеющие право на участие в розыгрыше. Если пусто, то все пользователи могут участвовать в розыгрыше. Пользователи с номером телефона, купленным на Fragment, всегда могут участвовать в розыгрышах. |
| prize_star_count | Integer | Необязательное. Количество Telegram Stars, которые будут распределены между победителями розыгрыша; только для розыгрышей Telegram Stars |
| premium_subscription_month_count | Integer | Необязательное. Количество месяцев, в течение которых будет активна подписка Telegram Premium, выигранная в розыгрыше; только для розыгрышей Telegram Premium |
Примеры
json
{
"chats": [
{
"id": -1001234567890,
"title": "Official Channel",
"type": "channel"
},
{
"id": -1009876543210,
"title": "Support Group",
"type": "supergroup"
}
],
"winners_selection_date": 1704067200,
"winner_count": 5,
"only_new_members": true,
"has_public_winners": false,
"prize_description": "1-year Premium subscription + 1000 Stars",
"country_codes": ["US", "CA", "GB"],
"prize_star_count": 1000,
"premium_subscription_month_count": 12
}История изменений
- API 7.0. Добавлен объект Giveaway
- API 7.10. Обновлен объект Giveaway: Добавлено поле prize_star_count
Дополнительно
- Chat - Объект, представляющий чат в Telegram с его основными характеристиками и типом.