Тип данных InlineQueryResultGif

Объект, представляющий ссылку на анимированный GIF-файл для встроенных запросов Telegram Bot API.

Описание

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

Поле Тип Описание
type String Тип результата, должен быть gif
id String Уникальный идентификатор для этого результата, 1-64 байта
gif_url String Действительный URL для GIF-файла
gif_width Integer Необязательно. Ширина GIF
gif_height Integer Необязательно. Высота GIF
gif_duration Integer Необязательно. Длительность GIF в секундах
thumbnail_url String URL статической (JPEG или GIF) или анимированной (MPEG4) миниатюры для результата
thumbnail_mime_type String Необязательно. MIME-тип миниатюры, должен быть одним из “image/jpeg”, “image/gif” или “video/mp4”. По умолчанию “image/jpeg”
title String Необязательно. Заголовок для результата
caption String Необязательно. Подпись к отправляемому GIF-файлу, 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 Необязательно. Содержимое сообщения, которое будет отправлено вместо GIF-анимации

Примеры

json

{
  "type": "gif",
  "id": "unique_gif_result_123",
  "gif_url": "https://example.com/animation.gif",
  "gif_width": 320,
  "gif_height": 240,
  "gif_duration": 5,
  "thumbnail_url": "https://example.com/thumbnail.jpg",
  "thumbnail_mime_type": "image/jpeg",
  "title": "Funny Animation",
  "caption": "Check out this *awesome* GIF!",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 12,
      "length": 7
    }
  ],
  "show_caption_above_media": false,
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Share",
          "callback_data": "share_gif_123"
        },
        {
          "text": "Open",
          "url": "https://example.com/fullscreen"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Here's an alternative text message instead of the GIF!",
    "parse_mode": "HTML"
  }
}

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

  • API 3.0. Обновлен объект InlineQueryResultGif: Добавлено поле gif_duration
  • API 4.9. Обновлен объект InlineQueryResultGif: Добавлена поддержка видео-миниатюр
  • API 5.0. Обновлен объект InlineQueryResultGif: Добавлена возможность ручного указания текстовых сущностей
  • API 6.6. Обновлен объект InlineQueryResultGif: Переименованы поля thumb_url и thumb_mime_type в thumbnail_url и thumbnail_mime_type
  • API 7.4. Обновлен объект InlineQueryResultGif: Добавлено поле show_caption_above_media

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

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