Animation

class telegram.Animation(file_id, file_unique_id, width, height, duration, file_name=None, mime_type=None, file_size=None, thumbnail=None, *, api_kwargs=None)[source]

Bases: telegram.TelegramObject

This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their file_unique_id is equal.

Changed in version 20.5: Removed the deprecated argument and attribute thumb.

Parameters:
  • file_id (str) – Identifier for this file, which can be used to download or reuse the file.

  • file_unique_id (str) – Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

  • width (int) – Video width as defined by the sender.

  • height (int) – Video height as defined by the sender.

  • duration (int) – Duration of the video in seconds as defined by the sender.

  • file_name (str, optional) – Original animation filename as defined by the sender.

  • mime_type (str, optional) – MIME type of the file as defined by the sender.

  • file_size (int, optional) – File size in bytes.

  • thumbnail (telegram.PhotoSize, optional) –

    Animation thumbnail as defined by sender.

    Added in version 20.2.

file_id[source]

Identifier for this file, which can be used to download or reuse the file.

Type:

str

file_unique_id[source]

Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

Type:

str

width[source]

Video width as defined by the sender.

Type:

int

height[source]

Video height as defined by the sender.

Type:

int

duration[source]

Duration of the video in seconds as defined by the sender.

Type:

int

file_name[source]

Optional. Original animation filename as defined by the sender.

Type:

str

mime_type[source]

Optional. MIME type of the file as defined by the sender.

Type:

str

file_size[source]

Optional. File size in bytes.

Type:

int

thumbnail[source]

Optional. Animation thumbnail as defined by sender.

Added in version 20.2.

Type:

telegram.PhotoSize

classmethod de_json(data, bot=None)[source]

See telegram.TelegramObject.de_json().

async get_file(*, read_timeout=None, write_timeout=None, connect_timeout=None, pool_timeout=None, api_kwargs=None)[source]

Convenience wrapper over telegram.Bot.get_file()

For the documentation of the arguments, please see telegram.Bot.get_file().

Returns:

telegram.File

Raises:

telegram.error.TelegramError