Тип данных InputMediaDocument

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

Описание

Представляет общий файл для отправки.

Поле Тип Описание
type String Тип результата, должен быть document
media String Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram (рекомендуется), передайте HTTP URL, чтобы Telegram получил файл из Интернета, или передайте "attach://" для загрузки нового файла с использованием multipart/form-data под именем . Подробнее об отправке файлов »
thumbnail String Опционально. Миниатюра отправляемого файла; может быть проигнорирована, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота миниатюры не должны превышать 320. Игнорируется, если файл не загружается с использованием multipart/form-data. Миниатюры нельзя повторно использовать, их можно загружать только как новый файл, поэтому вы можете передать "attach://", если миниатюра была загружена с использованием multipart/form-data под именем . Подробнее об отправке файлов »
caption String Опционально. Подпись к отправляемому документу, 0-1024 символа после обработки сущностей
parse_mode String Опционально. Режим обработки сущностей в подписи к документу. См. параметры форматирования для получения подробной информации.
caption_entities Массив объектов MessageEntity Опционально. Список специальных сущностей, которые появляются в подписи и могут быть указаны вместо parse_mode
disable_content_type_detection Boolean Опционально. Отключает автоматическое определение типа содержимого на стороне сервера для файлов, загруженных с использованием multipart/form-data. Всегда True, если документ отправляется как часть альбома.

Примеры

json

{
  "type": "document",
  "media": "attach://document_file",
  "thumbnail": "attach://thumbnail_file",
  "caption": "Check out this important document!",
  "parse_mode": "HTML",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 0,
      "length": 4
    }
  ],
  "disable_content_type_detection": true
}

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

  • API 4.0. Добавлен объект InputMediaDocument
  • API 5.0. Обновлен объект InputMediaDocument: Добавлен параметр disable_content_type_detection
  • API 6.6. Обновлен объект InputMediaDocument: Переименовано поле thumb в thumbnail

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

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