Описание
Этот объект содержит информацию об опросе.
| Поле | Тип | Описание |
|---|---|---|
| id | String | Уникальный идентификатор опроса |
| question | String | Вопрос опроса, 1-300 символов |
| question_entities | Array of MessageEntity | Опционально. Специальные сущности, которые появляются в question. В настоящее время в вопросах опросов разрешены только сущности пользовательских эмодзи |
| options | Array of PollOption | Список вариантов опроса |
| total_voter_count | Integer | Общее количество пользователей, проголосовавших в опросе |
| is_closed | Boolean | True, если опрос закрыт |
| is_anonymous | Boolean | True, если опрос анонимный |
| type | String | Тип опроса, в настоящее время может быть "regular" или "quiz" |
| allows_multiple_answers | Boolean | True, если опрос допускает несколько ответов |
| allows_revoting | Boolean | True, если опрос позволяет изменять выбранные варианты ответа |
| correct_option_ids | Array of Integer | Опционально. Массив 0-индексированных идентификаторов правильных вариантов ответа. Доступен только для опросов в режиме викторины, которые закрыты или были отправлены (не пересланы) ботом или в приватный чат с ботом |
| explanation | String | Опционально. Текст, который показывается, когда пользователь выбирает неправильный ответ или нажимает на иконку лампочки в опросе в стиле викторины, 0-200 символов |
| explanation_entities | Array of MessageEntity | Опционально. Специальные сущности, такие как имена пользователей, URL, команды ботов и т.д., которые появляются в explanation |
| open_period | Integer | Опционально. Время в секундах, в течение которого опрос будет активен после создания |
| close_date | Integer | Опционально. Момент времени (Unix timestamp), когда опрос будет автоматически закрыт |
| description | String | Опционально. Описание опроса; только для опросов внутри объекта Message |
| description_entities | Array of MessageEntity | Опционально. Специальные сущности, такие как имена пользователей, URL, команды ботов и т.д., которые появляются в описании |
Примеры
json
{
"id": "123456789012345678",
"question": "What is your favorite programming language?",
"question_entities": [
{
"type": "custom_emoji",
"offset": 0,
"length": 4,
"custom_emoji_id": "1234567890123456"
}
],
"options": [
{
"text": "Python",
"voter_count": 42
},
{
"text": "JavaScript",
"voter_count": 35
},
{
"text": "Go",
"voter_count": 18
},
{
"text": "Rust",
"voter_count": 12
}
],
"total_voter_count": 107,
"is_closed": false,
"is_anonymous": true,
"type": "regular",
"allows_multiple_answers": false,
"correct_option_id": 0,
"explanation": "Python is widely used for its simplicity.",
"explanation_entities": [
{
"type": "bold",
"offset": 0,
"length": 6
}
],
"open_period": 86400,
"close_date": 1672531200
}История изменений
- API 4.2. Добавлен объект Poll
- API 4.6. Обновлен объект Poll: Добавлены поля total_voter_count, is_anonymous, type, allows_multiple_answers, correct_option_id
- API 4.8. Обновлен объект Poll: Добавлены поля explanation, explanation_entities, open_period, close_date
- API 7.3. Обновлен объект Poll: Добавлено поле question_entities
- API 9.6. Обновлен объект Poll: Заменили поле correct_option_id на поле correct_option_ids в классе Poll
- API 9.6. Обновлен объект Poll: Добавили поле allows_revoting к классу Poll
- API 9.6. Обновлен объект Poll: Добавили поля description и description_entities к классу Poll
Дополнительно
- MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
- PollOption - Объект, представляющий один вариант ответа в опросе Telegram с текстом, сущностями форматирования и количеством голосов.
- Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.