Описание
Представляет общий файл для отправки.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть document |
| media | String | Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram (рекомендуется), передайте HTTP URL, чтобы Telegram получил файл из Интернета, или передайте "attach:// |
| thumbnail | String | Опционально. Миниатюра отправляемого файла; может быть проигнорирована, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота миниатюры не должны превышать 320. Игнорируется, если файл не загружается с использованием multipart/form-data. Миниатюры нельзя повторно использовать, их можно загружать только как новый файл, поэтому вы можете передать "attach:// |
| 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 представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.