Описание
Описывает уникальный подарок, полученный и принадлежащий пользователю или чату.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип подарка, всегда "unique" |
| gift | UniqueGift | Информация об уникальном подарке |
| owned_gift_id | String | Опционально. Уникальный идентификатор полученного подарка для бота; только для подарков, полученных от имени бизнес-аккаунтов |
| sender_user | User | Опционально. Отправитель подарка, если это известный пользователь |
| send_date | Integer | Дата отправки подарка в Unix-времени |
| is_saved | True | Опционально. True, если подарок отображается на странице профиля аккаунта; только для подарков, полученных от имени бизнес-аккаунтов |
| can_be_transferred | True | Опционально. True, если подарок можно передать другому владельцу; только для подарков, полученных от имени бизнес-аккаунтов |
| transfer_star_count | Integer | Опционально. Количество Telegram Stars, которые необходимо заплатить для передачи подарка; отсутствует, если бот не может передать подарок |
| next_transfer_date | Integer | Опционально. Момент времени (Unix timestamp), когда подарок можно передать; если он в прошлом, то подарок можно передать сейчас |
Примеры
json
{
"type": "unique",
"gift": {
"id": "unique_gift_12345",
"title": "Golden Star Trophy",
"description": "Awarded for exceptional contributions",
"thumbnail": {
"file_id": "AgACAgUAAxkBAAIB",
"file_unique_id": "AQADBAADT6o5Uw",
"width": 320,
"height": 320
},
"value": 500
},
"owned_gift_id": "owned_67890",
"sender_user": {
"id": 123456789,
"is_bot": false,
"first_name": "Alex",
"last_name": "Johnson",
"username": "alex_j"
},
"send_date": 1698765432,
"is_saved": true,
"can_be_transferred": true,
"transfer_star_count": 100,
"next_transfer_date": 1701388800
}История изменений
- API 9.0. Добавлен объект OwnedGiftUnique
- API 9.1. Обновлен объект OwnedGiftUnique: Добавлено поле next_transfer_date
Дополнительно
- UniqueGift - Объект описывает уникальный подарок, созданный путём улучшения обычного подарка, с информацией о его происхождении, уникальных характеристиках и визуальных элементах.
- User - Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.