Тип данных InlineQueryResultPhoto

Описание

Представляет ссылку на фотографию. По умолчанию эта фотография будет отправлена пользователем с необязательной подписью. В качестве альтернативы можно использовать input_message_content для отправки сообщения с указанным содержимым вместо фотографии.

Поле	Тип	Описание
type	String	Тип результата, должен быть photo
id	String	Уникальный идентификатор этого результата, 1-64 байта
photo_url	String	Действительный URL фотографии. Фотография должна быть в формате JPEG. Размер фотографии не должен превышать 5 МБ
thumbnail_url	String	URL миниатюры для фотографии
photo_width	Integer	Необязательное. Ширина фотографии
photo_height	Integer	Необязательное. Высота фотографии
title	String	Необязательное. Заголовок для результата
description	String	Необязательное. Краткое описание результата
caption	String	Необязательное. Подпись к отправляемой фотографии, 0-1024 символа после обработки сущностей
parse_mode	String	Необязательное. Режим обработки сущностей в подписи к фотографии. Подробнее см. параметры форматирования.
caption_entities	Array of MessageEntity	Необязательное. Список специальных сущностей, которые появляются в подписи и могут быть указаны вместо parse_mode
show_caption_above_media	Boolean	Необязательное. Передайте True, если подпись должна отображаться над медиафайлом сообщения
reply_markup	InlineKeyboardMarkup	Необязательное. Встроенная клавиатура, прикреплённая к сообщению
input_message_content	InputMessageContent	Необязательное. Содержимое сообщения, которое будет отправлено вместо фотографии

Примеры

json

{
  "type": "photo",
  "id": "unique_photo_result_123",
  "photo_url": "https://example.com/images/sample.jpg",
  "thumbnail_url": "https://example.com/thumbnails/sample_thumb.jpg",
  "photo_width": 1920,
  "photo_height": 1080,
  "title": "Beautiful Landscape",
  "description": "A scenic mountain view at sunset",
  "caption": "Check out this amazing view! *Sunset* over the mountains 🌄",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 24,
      "length": 6
    }
  ],
  "show_caption_above_media": true,
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "View Details",
          "url": "https://example.com/details"
        },
        {
          "text": "Share",
          "callback_data": "share_photo_123"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Here's the photo you requested: https://example.com/images/sample.jpg",
    "parse_mode": "HTML"
  }
}

История изменений

API 5.0. Обновлен объект InlineQueryResultPhoto: Добавлена возможность ручного указания текстовых сущностей
API 6.6. Обновлен объект InlineQueryResultPhoto: Переименовано поле thumb_url в thumbnail_url
API 7.4. Обновлен объект InlineQueryResultPhoto: Добавлено поле show_caption_above_media

Дополнительно

MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
InputMessageContent - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.