telegram.Document

class telegram.Document(file_id, thumb=None, file_name=None, mime_type=None, file_size=None, bot=None, **kwargs)

Bases: telegram.base.TelegramObject

This object represents a general file (as opposed to photos, voice messages and audio files).

file_id

str – Unique file identifier.

thumb

telegram.PhotoSize – Optional. Document thumbnail.

file_name

str – Original filename.

mime_type

str – Optional. MIME type of the file.

file_size

int – Optional. File size.

bot

telegram.Bot – Optional. The Bot to use for instance methods.

Parameters:
  • file_id (str) – Unique file identifier
  • thumb (telegram.PhotoSize, optional) – Document thumbnail as defined by sender.
  • file_name (str, optional) – Original filename as defined by sender.
  • mime_type (str, optional) – MIME type of the file as defined by sender.
  • file_size (int, optional) – File size.
  • bot (telegram.Bot, optional) – The Bot to use for instance methods.
  • **kwargs (dict) – Arbitrary keyword arguments.
get_file(timeout=None, **kwargs)

Convenience wrapper over telegram.Bot.get_file

Parameters:
  • timeout (int | float, optional) – If this value is specified, use it as the read timeout from the server (instead of the one specified during creation of the connection pool).
  • **kwargs (dict) – Arbitrary keyword arguments.
Returns:

telegram.File
Raises:

telegram.TelegramError