Описание
Этот объект представляет собой общий файл (в отличие от PhotoSize, Voice и Audio).
| Поле | Тип | Описание |
|---|---|---|
| file_id | String | Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла |
| file_unique_id | String | Уникальный идентификатор этого файла, который должен оставаться неизменным с течением времени и для разных ботов. Не может использоваться для загрузки или повторного использования файла. |
| thumbnail | PhotoSize | Необязательный. Миниатюра документа, определённая отправителем |
| file_name | String | Необязательный. Оригинальное имя файла, определённое отправителем |
| mime_type | String | Необязательный. MIME-тип файла, определённый отправителем |
| file_size | Integer | Необязательный. Размер файла в байтах. Может превышать 2^31, и некоторые языки программирования могут иметь сложности/скрытые ошибки при его интерпретации. Однако он имеет не более 52 значащих битов, поэтому для хранения этого значения безопасно использовать знаковый 64-битный целочисленный тип или тип двойной точности с плавающей запятой. |
Примеры
json
{
"file_id": "BQACAgIAAxkBAAIBFmZ0u3pK3qKzTQABHvV4Xy7X7_5LAAJhCwACpzHQS6v4AAHjPmuHwy8E",
"file_unique_id": "AgADYQsAAqcx0Es",
"thumbnail": {
"file_id": "AAMCAgADGQEAAgEWZnS7ekreorNNAEe9XhfLtfv_kgACYQsAAqcx0EurgAB4z5rh8AEAB20AAy8E",
"file_unique_id": "AQADYQsAAqcx0Ety",
"width": 320,
"height": 180,
"file_size": 12345
},
"file_name": "example_document.pdf",
"mime_type": "application/pdf",
"file_size": 1048576
}История изменений
- API 4.5. Обновлен объект Document: Добавлено поле file_unique_id
- API 6.6. Обновлен объект Document: Переименовано поле thumb в thumbnail
Дополнительно
- PhotoSize - Объект, представляющий один размер фотографии или миниатюры файла/стикера с метаданными файла.
- Voice - Объект, представляющий голосовое сообщение в Telegram Bot API.
- Audio - Объект, представляющий музыкальный аудиофайл в Telegram с метаданными, такими как длительность, исполнитель и обложка альбома.