Описание
Описывает служебное сообщение об уникальном подарке, который был отправлен или получен.
| Поле | Тип | Описание |
|---|---|---|
| gift | UniqueGift | Информация о подарке |
| origin | String | Происхождение подарка. В настоящее время может быть "upgrade" для подарков, улучшенных из обычных подарков, "transfer" для подарков, переданных от других пользователей или каналов, или "resale" для подарков, купленных у других пользователей |
| last_resale_star_count | Integer | Необязательное. Для подарков, купленных у других пользователей, цена, уплаченная за подарок |
| owned_gift_id | String | Необязательное. Уникальный идентификатор полученного подарка для бота; присутствует только для подарков, полученных от имени бизнес-аккаунтов |
| transfer_star_count | Integer | Необязательное. Количество Telegram Stars, которое необходимо заплатить для передачи подарка; отсутствует, если бот не может передать подарок |
| next_transfer_date | Integer | Необязательное. Момент времени (Unix timestamp), когда подарок можно передать. Если он в прошлом, то подарок можно передать сейчас |
Примеры
json
{
"gift": {
"id": "unique_gift_123456",
"title": "Golden Telegram Star",
"description": "A rare collectible star",
"photo": [
{
"file_id": "AgACAgUAAxkBAAIB",
"file_unique_id": "AQADBAADT6o5Vw",
"width": 512,
"height": 512,
"file_size": 12345
}
],
"star_count": 500
},
"origin": "transfer",
"last_resale_star_count": 450,
"owned_gift_id": "owned_gift_789012",
"transfer_star_count": 50,
"next_transfer_date": 1735689600
}История изменений
- API 9.0. Добавлен объект UniqueGiftInfo
- API 9.1. Обновлен объект UniqueGiftInfo: Добавлены поля next_transfer_date и last_resale_star_count, обновлено поле origin
- API 9.3. Обновлен объект UniqueGiftInfo: Поле last_resale_star_count заменено на last_resale_currency и last_resale_amount. Добавлены значения 'gifted_upgrade' и 'offer' для поля origin.
Дополнительно
- UniqueGift - Объект описывает уникальный подарок, созданный путём улучшения обычного подарка, с информацией о его происхождении, уникальных характеристиках и визуальных элементах.