Описание
Представляет ссылку на фотографию, хранящуюся на серверах Telegram. По умолчанию эта фотография будет отправлена пользователем с необязательной подписью. В качестве альтернативы можно использовать input_message_content для отправки сообщения с указанным содержимым вместо фотографии.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть photo |
| id | String | Уникальный идентификатор этого результата, 1-64 байта |
| photo_file_id | String | Действительный идентификатор файла фотографии |
| title | String | Необязательно. Заголовок результата |
| description | String | Необязательно. Краткое описание результата |
| caption | String | Необязательно. Подпись к отправляемой фотографии, 0-1024 символа после обработки сущностей |
| parse_mode | String | Необязательно. Режим обработки сущностей в подписи к фотографии. Подробнее см. параметры форматирования. |
| caption_entities | Массив MessageEntity | Необязательно. Список специальных сущностей в подписи, которые можно указать вместо parse_mode |
| show_caption_above_media | Boolean | Необязательно. Передайте True, если подпись должна отображаться над медиафайлом сообщения |
| reply_markup | InlineKeyboardMarkup | Необязательно. Встроенная клавиатура, прикреплённая к сообщению |
| input_message_content | InputMessageContent | Необязательно. Содержимое сообщения, которое будет отправлено вместо фотографии |
Примеры
json
{
"type": "photo",
"id": "unique_result_123",
"photo_file_id": "AgACAgQAAxkBAAIB",
"title": "Beautiful Sunset",
"description": "A cached photo from our server",
"caption": "Check out this amazing sunset! 🌅",
"parse_mode": "HTML",
"caption_entities": [
{
"type": "bold",
"offset": 0,
"length": 4
}
],
"show_caption_above_media": true,
"reply_markup": {
"inline_keyboard": [
[
{
"text": "View Details",
"callback_data": "photo_details_123"
}
]
]
},
"input_message_content": {
"message_text": "This photo has been sent from cache.",
"parse_mode": "Markdown"
}
}История изменений
- API 5.0. Обновлен объект InlineQueryResultCachedPhoto: Добавлена возможность ручного указания текстовых сущностей
- API 7.4. Обновлен объект InlineQueryResultCachedPhoto: Добавлено поле show_caption_above_media
Дополнительно
- MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
- InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
- InputMessageContent - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.