Описание
Этот объект представляет собой стикер.
| Поле | Тип | Описание |
|---|---|---|
| file_id | String | Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла |
| file_unique_id | String | Уникальный идентификатор этого файла, который должен оставаться неизменным с течением времени и для разных ботов. Не может использоваться для загрузки или повторного использования файла. |
| type | String | Тип стикера, в настоящее время один из «regular», «mask», «custom_emoji». Тип стикера не зависит от его формата, который определяется полями is_animated и is_video. |
| width | Integer | Ширина стикера |
| height | Integer | Высота стикера |
| is_animated | Boolean | True, если стикер анимированный |
| is_video | Boolean | True, если стикер является видеостикером |
| thumbnail | PhotoSize | Опционально. Миниатюра стикера в формате .WEBP или .JPG |
| emoji | String | Опционально. Эмодзи, связанное со стикером |
| set_name | String | Опционально. Название набора стикеров, к которому принадлежит стикер |
| premium_animation | File | Опционально. Для премиум обычных стикеров — премиальная анимация для стикера |
| mask_position | MaskPosition | Опционально. Для масок-стикеров — позиция, где должна быть размещена маска |
| custom_emoji_id | String | Опционально. Для пользовательских эмодзи-стикеров — уникальный идентификатор пользовательского эмодзи |
| needs_repainting | True | Опционально. True, если стикер должен быть перекрашен в цвет текста в сообщениях, цвет значка Telegram Premium в статусе эмодзи, белый цвет на фотографиях чатов или другой подходящий цвет в других местах |
| file_size | Integer | Опционально. Размер файла в байтах |
Примеры
json
{
"file_id": "CAACAgIAAxkBAAIBOWZPq3q3q3q3q3q3q3q3q3q3q3q3AAIEAQACFkJrCkD8AAEiQq3q3gQ",
"file_unique_id": "AgADBAEAAhaCawpA",
"type": "regular",
"width": 512,
"height": 512,
"is_animated": false,
"is_video": false,
"thumbnail": {
"file_id": "AAMCAgADGQEAAgE5Zk-rererererererererere_BAEAQACFkJrCkD8AAEiQq3q3gQ",
"file_unique_id": "AQADBAEAAnJKQwAB",
"width": 320,
"height": 320,
"file_size": 12345
},
"emoji": "😀",
"set_name": "MyStickerSet",
"file_size": 20480
}История изменений
- API 3.2. Обновлен объект Sticker: Добавлены поля set_name и mask_position
- API 4.4. Обновлен объект Sticker: Добавлено поле is_animated
- API 4.5. Обновлен объект Sticker: Добавлено поле file_unique_id
- API 5.7. Обновлен объект Sticker: Добавлено поле is_video
- API 6.1. Обновлен объект Sticker: Добавлено поле premium_animation
- API 6.2. Обновлен объект Sticker: Добавлены поля type и custom_emoji_id
- API 6.6. Обновлен объект Sticker: Добавлено поле needs_repainting
Дополнительно
- PhotoSize - Объект, представляющий один размер фотографии или миниатюры файла/стикера с метаданными файла.
- File - Объект, представляющий файл, доступный для скачивания через Telegram Bot API, с информацией о его идентификаторах, размере и пути.
- MaskPosition - Объект, определяющий стандартное положение маски на лице с возможностью смещения и масштабирования.