Тип данных InlineQueryResultVideo

Описание

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

Если сообщение InlineQueryResultVideo содержит встроенное видео (например, YouTube), вы обязаны заменить его содержимое с помощью input_message_content.

Поле	Тип	Описание
type	String	Тип результата, должен быть video
id	String	Уникальный идентификатор результата, 1-64 байта
video_url	String	Действительный URL для встроенного видеоплеера или видеофайла
mime_type	String	MIME-тип содержимого видео URL, «text/html» или «video/mp4»
thumbnail_url	String	URL миниатюры (только JPEG) для видео
title	String	Заголовок результата
caption	String	Необязательно. Подпись к отправляемому видео, 0-1024 символа после обработки сущностей
parse_mode	String	Необязательно. Режим обработки сущностей в подписи к видео. Подробнее см. параметры форматирования.
caption_entities	Массив MessageEntity	Необязательно. Список специальных сущностей в подписи, которые можно указать вместо parse_mode
show_caption_above_media	Boolean	Необязательно. Передайте True, если подпись должна отображаться над медиафайлом сообщения
video_width	Integer	Необязательно. Ширина видео
video_height	Integer	Необязательно. Высота видео
video_duration	Integer	Необязательно. Длительность видео в секундах
description	String	Необязательно. Краткое описание результата
reply_markup	InlineKeyboardMarkup	Необязательно. Инлайн-клавиатура, прикреплённая к сообщению
input_message_content	InputMessageContent	Необязательно. Содержимое сообщения для отправки вместо видео. Это поле обязательно, если InlineQueryResultVideo используется для отправки HTML-страницы в качестве результата (например, видео YouTube).

Примеры

json

{
  "type": "video",
  "id": "unique_video_result_001",
  "video_url": "https://example.com/video.mp4",
  "mime_type": "video/mp4",
  "thumbnail_url": "https://example.com/thumbnail.jpg",
  "title": "Amazing Nature Video",
  "caption": "Check out this beautiful scenery! #nature",
  "parse_mode": "HTML",
  "caption_entities": [
    {
      "type": "hashtag",
      "offset": 31,
      "length": 7
    }
  ],
  "show_caption_above_media": false,
  "video_width": 1920,
  "video_height": 1080,
  "video_duration": 120,
  "description": "A short video showcasing natural landscapes",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Watch Full Video",
          "url": "https://example.com/full-video"
        },
        {
          "text": "Share",
          "callback_data": "share_video_001"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Here's an amazing nature video for you!",
    "parse_mode": "HTML"
  }
}

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

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

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

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