From 6dc02c0bfa6609eac95eaeb61db559d8167bbf04 Mon Sep 17 00:00:00 2001 From: Alex Root Junior Date: Thu, 9 Mar 2023 19:46:53 +0200 Subject: [PATCH] Refresh from docs --- .butcher/methods/addStickerToSet/entity.json | 46 +- .../methods/createNewStickerSet/entity.json | 78 +- .butcher/methods/deleteStickerSet/entity.json | 4 +- .../editMessageLiveLocation/entity.json | 4 +- .butcher/methods/getMyDescription/entity.json | 4 +- .../methods/getMyShortDescription/entity.json | 4 +- .butcher/methods/sendAnimation/entity.json | 10 +- .butcher/methods/sendAudio/entity.json | 10 +- .butcher/methods/sendDocument/entity.json | 10 +- .butcher/methods/sendSticker/entity.json | 16 +- .butcher/methods/sendVideo/entity.json | 10 +- .butcher/methods/sendVideoNote/entity.json | 10 +- .../entity.json | 4 +- .../entity.json | 6 +- .butcher/methods/setMyDescription/entity.json | 4 +- .../methods/setMyShortDescription/entity.json | 4 +- .../methods/setStickerEmojiList/entity.json | 4 +- .../methods/setStickerKeywords/entity.json | 4 +- .../setStickerMaskPosition/entity.json | 6 +- .../methods/setStickerSetThumb/entity.json | 43 - .../setStickerSetThumbnail/entity.json | 4 +- .../methods/setStickerSetTitle/entity.json | 4 +- .../stopMessageLiveLocation/entity.json | 4 +- .../methods/uploadStickerFile/entity.json | 22 +- .butcher/schema/schema.json | 1458 ++++++----------- .butcher/types/Animation/entity.json | 10 +- .butcher/types/Audio/entity.json | 8 - .butcher/types/BotDescription/entity.json | 4 +- .../types/BotShortDescription/entity.json | 4 +- .butcher/types/Document/entity.json | 10 +- .../InlineQueryResultArticle/entity.json | 24 - .../InlineQueryResultContact/entity.json | 24 - .../InlineQueryResultDocument/entity.json | 24 - .../types/InlineQueryResultGif/entity.json | 20 +- .../InlineQueryResultLocation/entity.json | 24 - .../InlineQueryResultMpeg4Gif/entity.json | 20 +- .../types/InlineQueryResultPhoto/entity.json | 10 +- .../types/InlineQueryResultVenue/entity.json | 24 - .../types/InlineQueryResultVideo/entity.json | 10 +- .../types/InputMediaAnimation/entity.json | 10 +- .butcher/types/InputMediaAudio/entity.json | 10 +- .butcher/types/InputMediaDocument/entity.json | 10 +- .butcher/types/InputMediaVideo/entity.json | 10 +- .butcher/types/InputSticker/entity.json | 4 +- .butcher/types/Sticker/entity.json | 26 +- .butcher/types/StickerSet/entity.json | 8 - .butcher/types/Video/entity.json | 10 +- .butcher/types/VideoNote/entity.json | 10 +- aiogram/client/bot.py | 128 +- aiogram/enums/__init__.py | 2 +- aiogram/methods/__init__.py | 24 +- aiogram/methods/add_sticker_to_set.py | 14 +- aiogram/methods/create_new_sticker_set.py | 16 +- aiogram/methods/send_animation.py | 4 +- aiogram/methods/send_audio.py | 4 +- aiogram/methods/send_document.py | 4 +- aiogram/methods/send_sticker.py | 4 +- aiogram/methods/send_video.py | 4 +- aiogram/methods/send_video_note.py | 4 +- .../set_my_default_administrator_rights.py | 2 +- aiogram/methods/set_sticker_keywords.py | 2 +- aiogram/methods/set_sticker_mask_position.py | 4 +- aiogram/methods/set_sticker_set_thumb.py | 34 - aiogram/methods/set_sticker_set_thumbnail.py | 2 +- aiogram/methods/upload_sticker_file.py | 8 +- aiogram/types/__init__.py | 6 +- aiogram/types/animation.py | 4 +- aiogram/types/audio.py | 2 - aiogram/types/document.py | 4 +- aiogram/types/inline_query_result_article.py | 6 - aiogram/types/inline_query_result_contact.py | 6 - aiogram/types/inline_query_result_document.py | 6 - aiogram/types/inline_query_result_gif.py | 6 +- aiogram/types/inline_query_result_location.py | 6 - .../types/inline_query_result_mpeg4_gif.py | 6 +- aiogram/types/inline_query_result_photo.py | 2 - aiogram/types/inline_query_result_venue.py | 6 - aiogram/types/inline_query_result_video.py | 4 +- aiogram/types/input_media_animation.py | 4 +- aiogram/types/input_media_audio.py | 4 +- aiogram/types/input_media_document.py | 4 +- aiogram/types/input_media_video.py | 4 +- aiogram/types/input_sticker.py | 2 +- aiogram/types/message.py | 102 +- aiogram/types/sticker.py | 8 +- aiogram/types/sticker_set.py | 2 - aiogram/types/video.py | 4 +- aiogram/types/video_note.py | 4 +- docs/api/methods/index.rst | 34 +- docs/api/types/index.rst | 13 +- 90 files changed, 760 insertions(+), 1836 deletions(-) delete mode 100644 .butcher/methods/setStickerSetThumb/entity.json delete mode 100644 aiogram/methods/set_sticker_set_thumb.py diff --git a/.butcher/methods/addStickerToSet/entity.json b/.butcher/methods/addStickerToSet/entity.json index 8ef4dd1d..cab8f7af 100644 --- a/.butcher/methods/addStickerToSet/entity.json +++ b/.butcher/methods/addStickerToSet/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "addstickertoset", "name": "addStickerToSet", - "description": "Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", - "html_description": "

Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", - "rst_description": "Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", + "description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", + "html_description": "

Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", + "rst_description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -29,46 +29,6 @@ "rst_description": "Sticker set name\n", "name": "name" }, - { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" - }, { "type": "InputSticker", "required": true, diff --git a/.butcher/methods/createNewStickerSet/entity.json b/.butcher/methods/createNewStickerSet/entity.json index 9ac4dfa0..34fcbfc5 100644 --- a/.butcher/methods/createNewStickerSet/entity.json +++ b/.butcher/methods/createNewStickerSet/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "createnewstickerset", "name": "createNewStickerSet", - "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.", - "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.

", - "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success.", + "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.", + "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.

", + "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -37,62 +37,6 @@ "rst_description": "Sticker set title, 1-64 characters\n", "name": "title" }, - { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": false, - "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", - "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", - "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", - "name": "sticker_type" - }, - { - "type": "String", - "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" - }, - { - "type": "Boolean", - "required": false, - "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", - "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", - "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", - "name": "needs_repainting" - }, { "type": "Array of InputSticker", "required": true, @@ -108,6 +52,22 @@ "html_description": "Format of stickers in the set, must be one of “static”, “animated”, “video”", "rst_description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'\n", "name": "sticker_format" + }, + { + "type": "String", + "required": false, + "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", + "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", + "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", + "name": "sticker_type" + }, + { + "type": "Boolean", + "required": false, + "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", + "name": "needs_repainting" } ], "category": "methods" diff --git a/.butcher/methods/deleteStickerSet/entity.json b/.butcher/methods/deleteStickerSet/entity.json index d57eb98f..1ae6f1ba 100644 --- a/.butcher/methods/deleteStickerSet/entity.json +++ b/.butcher/methods/deleteStickerSet/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "deletestickerset", diff --git a/.butcher/methods/editMessageLiveLocation/entity.json b/.butcher/methods/editMessageLiveLocation/entity.json index 7605f142..77e1beb1 100644 --- a/.butcher/methods/editMessageLiveLocation/entity.json +++ b/.butcher/methods/editMessageLiveLocation/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Available methods", - "anchor": "available-methods" + "title": "Updating messages", + "anchor": "updating-messages" }, "object": { "anchor": "editmessagelivelocation", diff --git a/.butcher/methods/getMyDescription/entity.json b/.butcher/methods/getMyDescription/entity.json index a9be39c0..7b231729 100644 --- a/.butcher/methods/getMyDescription/entity.json +++ b/.butcher/methods/getMyDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available methods", + "anchor": "available-methods" }, "object": { "anchor": "getmydescription", diff --git a/.butcher/methods/getMyShortDescription/entity.json b/.butcher/methods/getMyShortDescription/entity.json index 94c06269..10f51d1b 100644 --- a/.butcher/methods/getMyShortDescription/entity.json +++ b/.butcher/methods/getMyShortDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available methods", + "anchor": "available-methods" }, "object": { "anchor": "getmyshortdescription", diff --git a/.butcher/methods/sendAnimation/entity.json b/.butcher/methods/sendAnimation/entity.json index efaf33f4..5a11b343 100644 --- a/.butcher/methods/sendAnimation/entity.json +++ b/.butcher/methods/sendAnimation/entity.json @@ -67,7 +67,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -140,14 +140,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" diff --git a/.butcher/methods/sendAudio/entity.json b/.butcher/methods/sendAudio/entity.json index f73413f4..84eec416 100644 --- a/.butcher/methods/sendAudio/entity.json +++ b/.butcher/methods/sendAudio/entity.json @@ -91,7 +91,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -132,14 +132,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" diff --git a/.butcher/methods/sendDocument/entity.json b/.butcher/methods/sendDocument/entity.json index 999f49a0..31680179 100644 --- a/.butcher/methods/sendDocument/entity.json +++ b/.butcher/methods/sendDocument/entity.json @@ -43,7 +43,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -116,14 +116,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" diff --git a/.butcher/methods/sendSticker/entity.json b/.butcher/methods/sendSticker/entity.json index ca900433..aca9254c 100644 --- a/.butcher/methods/sendSticker/entity.json +++ b/.butcher/methods/sendSticker/entity.json @@ -37,6 +37,14 @@ "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.\n", "name": "sticker" }, + { + "type": "String", + "required": false, + "description": "Emoji associated with the sticker; only for just uploaded stickers", + "html_description": "Emoji associated with the sticker; only for just uploaded stickers", + "rst_description": "Emoji associated with the sticker; only for just uploaded stickers\n", + "name": "emoji" + }, { "type": "Boolean", "required": false, @@ -76,14 +84,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "String", - "required": false, - "description": "Emoji associated with the sticker; only for uploaded stickers", - "html_description": "Emoji associated with the sticker; only for uploaded stickers", - "rst_description": "Emoji associated with the sticker; only for uploaded stickers\n", - "name": "emoji" } ], "category": "methods" diff --git a/.butcher/methods/sendVideo/entity.json b/.butcher/methods/sendVideo/entity.json index 95e120ca..b19e2201 100644 --- a/.butcher/methods/sendVideo/entity.json +++ b/.butcher/methods/sendVideo/entity.json @@ -67,7 +67,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -148,14 +148,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" diff --git a/.butcher/methods/sendVideoNote/entity.json b/.butcher/methods/sendVideoNote/entity.json index 1df8a972..ea382889 100644 --- a/.butcher/methods/sendVideoNote/entity.json +++ b/.butcher/methods/sendVideoNote/entity.json @@ -59,7 +59,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -100,14 +100,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" diff --git a/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json b/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json index 27ed6813..a4b0e265 100644 --- a/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json +++ b/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setcustomemojistickersetthumbnail", diff --git a/.butcher/methods/setMyDefaultAdministratorRights/entity.json b/.butcher/methods/setMyDefaultAdministratorRights/entity.json index 687b8f3d..503198d7 100644 --- a/.butcher/methods/setMyDefaultAdministratorRights/entity.json +++ b/.butcher/methods/setMyDefaultAdministratorRights/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "setmydefaultadministratorrights", "name": "setMyDefaultAdministratorRights", - "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.", - "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.

", - "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success.", + "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.", + "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.

", + "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success.", "annotations": [ { "type": "ChatAdministratorRights", diff --git a/.butcher/methods/setMyDescription/entity.json b/.butcher/methods/setMyDescription/entity.json index 1dbab731..9487c34b 100644 --- a/.butcher/methods/setMyDescription/entity.json +++ b/.butcher/methods/setMyDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available methods", + "anchor": "available-methods" }, "object": { "anchor": "setmydescription", diff --git a/.butcher/methods/setMyShortDescription/entity.json b/.butcher/methods/setMyShortDescription/entity.json index 82b1cb08..0bb47047 100644 --- a/.butcher/methods/setMyShortDescription/entity.json +++ b/.butcher/methods/setMyShortDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available methods", + "anchor": "available-methods" }, "object": { "anchor": "setmyshortdescription", diff --git a/.butcher/methods/setStickerEmojiList/entity.json b/.butcher/methods/setStickerEmojiList/entity.json index ac3f68cd..92d1fd39 100644 --- a/.butcher/methods/setStickerEmojiList/entity.json +++ b/.butcher/methods/setStickerEmojiList/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setstickeremojilist", diff --git a/.butcher/methods/setStickerKeywords/entity.json b/.butcher/methods/setStickerKeywords/entity.json index 602410cb..cabf2fbe 100644 --- a/.butcher/methods/setStickerKeywords/entity.json +++ b/.butcher/methods/setStickerKeywords/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setstickerkeywords", diff --git a/.butcher/methods/setStickerMaskPosition/entity.json b/.butcher/methods/setStickerMaskPosition/entity.json index f60a2963..e18fbd04 100644 --- a/.butcher/methods/setStickerMaskPosition/entity.json +++ b/.butcher/methods/setStickerMaskPosition/entity.json @@ -3,15 +3,15 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setstickermaskposition", "name": "setStickerMaskPosition", "description": "Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.", "html_description": "

Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.

", - "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", + "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", "annotations": [ { "type": "String", diff --git a/.butcher/methods/setStickerSetThumb/entity.json b/.butcher/methods/setStickerSetThumb/entity.json deleted file mode 100644 index cc7739b3..00000000 --- a/.butcher/methods/setStickerSetThumb/entity.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "meta": { - "deprecated": false - }, - "group": { - "title": "Stickers", - "anchor": "stickers" - }, - "object": { - "anchor": "setstickersetthumb", - "name": "setStickerSetThumb", - "description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - }, - { - "type": "Integer", - "required": true, - "description": "User identifier of the sticker set owner", - "html_description": "User identifier of the sticker set owner", - "rst_description": "User identifier of the sticker set owner\n", - "name": "user_id" - }, - { - "type": "InputFile or String", - "required": false, - "description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "html_description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "rst_description": "A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.\n", - "name": "thumb" - } - ], - "category": "methods" - } -} diff --git a/.butcher/methods/setStickerSetThumbnail/entity.json b/.butcher/methods/setStickerSetThumbnail/entity.json index 56ed27d4..b5eac7cf 100644 --- a/.butcher/methods/setStickerSetThumbnail/entity.json +++ b/.butcher/methods/setStickerSetThumbnail/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setstickersetthumbnail", diff --git a/.butcher/methods/setStickerSetTitle/entity.json b/.butcher/methods/setStickerSetTitle/entity.json index eafcc563..757f508a 100644 --- a/.butcher/methods/setStickerSetTitle/entity.json +++ b/.butcher/methods/setStickerSetTitle/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "setstickersettitle", diff --git a/.butcher/methods/stopMessageLiveLocation/entity.json b/.butcher/methods/stopMessageLiveLocation/entity.json index 3ede9d40..6f1cb51c 100644 --- a/.butcher/methods/stopMessageLiveLocation/entity.json +++ b/.butcher/methods/stopMessageLiveLocation/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Available methods", - "anchor": "available-methods" + "title": "Updating messages", + "anchor": "updating-messages" }, "object": { "anchor": "stopmessagelivelocation", diff --git a/.butcher/methods/uploadStickerFile/entity.json b/.butcher/methods/uploadStickerFile/entity.json index cddc3041..687ae2cb 100644 --- a/.butcher/methods/uploadStickerFile/entity.json +++ b/.butcher/methods/uploadStickerFile/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "uploadstickerfile", "name": "uploadStickerFile", - "description": "Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.", - "html_description": "

Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.

", - "rst_description": "Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", + "description": "Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.", + "html_description": "

Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.

", + "rst_description": "Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", "annotations": [ { "type": "Integer", @@ -24,10 +24,10 @@ { "type": "InputFile", "required": true, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" + "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", + "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", + "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", + "name": "sticker" }, { "type": "String", @@ -36,14 +36,6 @@ "html_description": "Format of the sticker, must be one of “static”, “animated”, “video”", "rst_description": "Format of the sticker, must be one of 'static', 'animated', 'video'\n", "name": "sticker_format" - }, - { - "type": "InputFile", - "required": true, - "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", - "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", - "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", - "name": "sticker" } ], "category": "methods" diff --git a/.butcher/schema/schema.json b/.butcher/schema/schema.json index f2c58934..02015146 100644 --- a/.butcher/schema/schema.json +++ b/.butcher/schema/schema.json @@ -1,7 +1,7 @@ { "api": { - "version": "6.5", - "release_date": "2023-02-03" + "version": "6.6", + "release_date": "2023-03-09" }, "items": [ { @@ -1458,7 +1458,7 @@ "description": "Animation thumbnail as defined by sender", "html_description": "Optional. Animation thumbnail as defined by sender", "rst_description": "*Optional*. Animation thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1484,14 +1484,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Animation thumbnail as defined by the sender", - "html_description": "Optional. Animation thumbnail as defined by the sender", - "rst_description": "*Optional*. Animation thumbnail as defined by the sender\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -1567,14 +1559,6 @@ "name": "file_size", "required": false }, - { - "type": "PhotoSize", - "description": "Thumbnail of the album cover to which the music file belongs", - "html_description": "Optional. Thumbnail of the album cover to which the music file belongs", - "rst_description": "*Optional*. Thumbnail of the album cover to which the music file belongs\n", - "name": "thumb", - "required": false - }, { "type": "PhotoSize", "description": "Thumbnail of the album cover to which the music file belongs", @@ -1614,7 +1598,7 @@ "description": "Document thumbnail as defined by sender", "html_description": "Optional. Document thumbnail as defined by sender", "rst_description": "*Optional*. Document thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1640,14 +1624,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Document thumbnail as defined by the sender", - "html_description": "Optional. Document thumbnail as defined by the sender", - "rst_description": "*Optional*. Document thumbnail as defined by the sender\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -1704,7 +1680,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1730,14 +1706,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Video thumbnail", - "html_description": "Optional. Video thumbnail", - "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -1786,7 +1754,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1796,14 +1764,6 @@ "rst_description": "*Optional*. File size in bytes\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Video thumbnail", - "html_description": "Optional. Video thumbnail", - "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -4292,6 +4252,42 @@ ], "category": "types" }, + { + "anchor": "botdescription", + "name": "BotDescription", + "description": "This object represents the bot's description.", + "html_description": "

This object represents the bot's description.

", + "rst_description": "This object represents the bot's description.", + "annotations": [ + { + "type": "String", + "description": "The bot's description", + "html_description": "The bot's description", + "rst_description": "The bot's description\n", + "name": "description", + "required": true + } + ], + "category": "types" + }, + { + "anchor": "botshortdescription", + "name": "BotShortDescription", + "description": "This object represents the bot's short description.", + "html_description": "

This object represents the bot's short description.

", + "rst_description": "This object represents the bot's short description.", + "annotations": [ + { + "type": "String", + "description": "The bot's short description", + "html_description": "The bot's short description", + "rst_description": "The bot's short description\n", + "name": "short_description", + "required": true + } + ], + "category": "types" + }, { "anchor": "menubutton", "name": "MenuButton", @@ -4492,7 +4488,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4558,14 +4554,6 @@ "rst_description": "*Optional*. Pass :code:`True` if the video needs to be covered with a spoiler animation\n", "name": "has_spoiler", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -4598,7 +4586,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4656,14 +4644,6 @@ "rst_description": "*Optional*. Pass :code:`True` if the animation needs to be covered with a spoiler animation\n", "name": "has_spoiler", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -4696,7 +4676,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4746,14 +4726,6 @@ "rst_description": "*Optional*. Title of the audio\n", "name": "title", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -4786,7 +4758,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4820,14 +4792,6 @@ "rst_description": "*Optional*. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :code:`True`, if the document is sent as part of an album.\n", "name": "disable_content_type_detection", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" @@ -5328,7 +5292,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -5369,14 +5333,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" @@ -5418,7 +5374,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5491,14 +5447,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" @@ -5564,7 +5512,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5645,14 +5593,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" @@ -5718,7 +5658,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5791,14 +5731,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" @@ -5962,7 +5894,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -6003,14 +5935,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "InputFile or String", - "required": false, - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail" } ], "category": "methods" @@ -6195,130 +6119,6 @@ ], "category": "methods" }, - { - "anchor": "editmessagelivelocation", - "name": "editMessageLiveLocation", - "description": "Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.", - "html_description": "

Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.

", - "rst_description": "Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", - "annotations": [ - { - "type": "Integer or String", - "required": false, - "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", - "name": "chat_id" - }, - { - "type": "Integer", - "required": false, - "description": "Required if inline_message_id is not specified. Identifier of the message to edit", - "html_description": "Required if inline_message_id is not specified. Identifier of the message to edit", - "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message to edit\n", - "name": "message_id" - }, - { - "type": "String", - "required": false, - "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", - "name": "inline_message_id" - }, - { - "type": "Float number", - "required": true, - "description": "Latitude of new location", - "html_description": "Latitude of new location", - "rst_description": "Latitude of new location\n", - "name": "latitude" - }, - { - "type": "Float number", - "required": true, - "description": "Longitude of new location", - "html_description": "Longitude of new location", - "rst_description": "Longitude of new location\n", - "name": "longitude" - }, - { - "type": "Float number", - "required": false, - "description": "The radius of uncertainty for the location, measured in meters; 0-1500", - "html_description": "The radius of uncertainty for the location, measured in meters; 0-1500", - "rst_description": "The radius of uncertainty for the location, measured in meters; 0-1500\n", - "name": "horizontal_accuracy" - }, - { - "type": "Integer", - "required": false, - "description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", - "html_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", - "rst_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.\n", - "name": "heading" - }, - { - "type": "Integer", - "required": false, - "description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", - "html_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", - "rst_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.\n", - "name": "proximity_alert_radius" - }, - { - "type": "InlineKeyboardMarkup", - "required": false, - "description": "A JSON-serialized object for a new inline keyboard.", - "html_description": "A JSON-serialized object for a new inline keyboard.", - "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", - "name": "reply_markup" - } - ], - "category": "methods" - }, - { - "anchor": "stopmessagelivelocation", - "name": "stopMessageLiveLocation", - "description": "Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.", - "html_description": "

Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.

", - "rst_description": "Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", - "annotations": [ - { - "type": "Integer or String", - "required": false, - "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", - "name": "chat_id" - }, - { - "type": "Integer", - "required": false, - "description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", - "html_description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", - "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message with live location to stop\n", - "name": "message_id" - }, - { - "type": "String", - "required": false, - "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", - "name": "inline_message_id" - }, - { - "type": "InlineKeyboardMarkup", - "required": false, - "description": "A JSON-serialized object for a new inline keyboard.", - "html_description": "A JSON-serialized object for a new inline keyboard.", - "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", - "name": "reply_markup" - } - ], - "category": "methods" - }, { "anchor": "sendvenue", "name": "sendVenue", @@ -8188,6 +7988,94 @@ ], "category": "methods" }, + { + "anchor": "setmydescription", + "name": "setMyDescription", + "description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.", + "html_description": "

Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.

", + "rst_description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "html_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "rst_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.\n", + "name": "description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "getmydescription", + "name": "getMyDescription", + "description": "Use this method to get the current bot description for the given user language. Returns BotDescription on success.", + "html_description": "

Use this method to get the current bot description for the given user language. Returns BotDescription on success.

", + "rst_description": "Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "setmyshortdescription", + "name": "setMyShortDescription", + "description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.", + "html_description": "

Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.

", + "rst_description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "html_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "rst_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.\n", + "name": "short_description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "getmyshortdescription", + "name": "getMyShortDescription", + "description": "Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.", + "html_description": "

Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.

", + "rst_description": "Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + }, { "anchor": "setchatmenubutton", "name": "setChatMenuButton", @@ -8235,9 +8123,9 @@ { "anchor": "setmydefaultadministratorrights", "name": "setMyDefaultAdministratorRights", - "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.", - "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.

", - "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success.", + "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.", + "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.

", + "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success.", "annotations": [ { "type": "ChatAdministratorRights", @@ -8473,6 +8361,130 @@ ], "category": "methods" }, + { + "anchor": "editmessagelivelocation", + "name": "editMessageLiveLocation", + "description": "Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.", + "html_description": "

Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.

", + "rst_description": "Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", + "annotations": [ + { + "type": "Integer or String", + "required": false, + "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", + "name": "chat_id" + }, + { + "type": "Integer", + "required": false, + "description": "Required if inline_message_id is not specified. Identifier of the message to edit", + "html_description": "Required if inline_message_id is not specified. Identifier of the message to edit", + "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message to edit\n", + "name": "message_id" + }, + { + "type": "String", + "required": false, + "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", + "name": "inline_message_id" + }, + { + "type": "Float number", + "required": true, + "description": "Latitude of new location", + "html_description": "Latitude of new location", + "rst_description": "Latitude of new location\n", + "name": "latitude" + }, + { + "type": "Float number", + "required": true, + "description": "Longitude of new location", + "html_description": "Longitude of new location", + "rst_description": "Longitude of new location\n", + "name": "longitude" + }, + { + "type": "Float number", + "required": false, + "description": "The radius of uncertainty for the location, measured in meters; 0-1500", + "html_description": "The radius of uncertainty for the location, measured in meters; 0-1500", + "rst_description": "The radius of uncertainty for the location, measured in meters; 0-1500\n", + "name": "horizontal_accuracy" + }, + { + "type": "Integer", + "required": false, + "description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", + "html_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", + "rst_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.\n", + "name": "heading" + }, + { + "type": "Integer", + "required": false, + "description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", + "html_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", + "rst_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.\n", + "name": "proximity_alert_radius" + }, + { + "type": "InlineKeyboardMarkup", + "required": false, + "description": "A JSON-serialized object for a new inline keyboard.", + "html_description": "A JSON-serialized object for a new inline keyboard.", + "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", + "name": "reply_markup" + } + ], + "category": "methods" + }, + { + "anchor": "stopmessagelivelocation", + "name": "stopMessageLiveLocation", + "description": "Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.", + "html_description": "

Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.

", + "rst_description": "Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", + "annotations": [ + { + "type": "Integer or String", + "required": false, + "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", + "name": "chat_id" + }, + { + "type": "Integer", + "required": false, + "description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", + "html_description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", + "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message with live location to stop\n", + "name": "message_id" + }, + { + "type": "String", + "required": false, + "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", + "name": "inline_message_id" + }, + { + "type": "InlineKeyboardMarkup", + "required": false, + "description": "A JSON-serialized object for a new inline keyboard.", + "html_description": "A JSON-serialized object for a new inline keyboard.", + "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", + "name": "reply_markup" + } + ], + "category": "methods" + }, { "anchor": "editmessagereplymarkup", "name": "editMessageReplyMarkup", @@ -8650,7 +8662,7 @@ "description": "Sticker thumbnail in the .WEBP or .JPG format", "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -8693,22 +8705,6 @@ "name": "custom_emoji_id", "required": false }, - { - "type": "Integer", - "description": "File size in bytes", - "html_description": "Optional. File size in bytes", - "rst_description": "*Optional*. File size in bytes\n", - "name": "file_size", - "required": false - }, - { - "type": "PhotoSize", - "description": "Sticker thumbnail in the .WEBP or .JPG format", - "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", - "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumbnail", - "required": false - }, { "type": "True", "description": "True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", @@ -8716,6 +8712,14 @@ "rst_description": "*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places\n", "name": "needs_repainting", "required": false + }, + { + "type": "Integer", + "description": "File size in bytes", + "html_description": "Optional. File size in bytes", + "rst_description": "*Optional*. File size in bytes\n", + "name": "file_size", + "required": false } ], "category": "types" @@ -8775,14 +8779,6 @@ "name": "stickers", "required": true }, - { - "type": "PhotoSize", - "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", - "html_description": "Optional. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", - "rst_description": "*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format\n", - "name": "thumb", - "required": false - }, { "type": "PhotoSize", "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", @@ -8836,6 +8832,48 @@ ], "category": "types" }, + { + "anchor": "inputsticker", + "name": "InputSticker", + "description": "This object describes a sticker to be added to a sticker set.", + "html_description": "

This object describes a sticker to be added to a sticker set.

", + "rst_description": "This object describes a sticker to be added to a sticker set.", + "annotations": [ + { + "type": "InputFile or String", + "description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files", + "html_description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files »", + "rst_description": "The added sticker. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `\n", + "name": "sticker", + "required": true + }, + { + "type": "Array of String", + "description": "List of 1-20 emoji associated with the sticker", + "html_description": "List of 1-20 emoji associated with the sticker", + "rst_description": "List of 1-20 emoji associated with the sticker\n", + "name": "emoji_list", + "required": true + }, + { + "type": "MaskPosition", + "description": "Position where the mask should be placed on faces. For 'mask' stickers only.", + "html_description": "Optional. Position where the mask should be placed on faces. For “mask” stickers only.", + "rst_description": "*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.\n", + "name": "mask_position", + "required": false + }, + { + "type": "Array of String", + "description": "List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.", + "html_description": "Optional. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For “regular” and “custom_emoji” stickers only.", + "rst_description": "*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.\n", + "name": "keywords", + "required": false + } + ], + "category": "types" + }, { "anchor": "sendsticker", "name": "sendSticker", @@ -8867,6 +8905,14 @@ "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.\n", "name": "sticker" }, + { + "type": "String", + "required": false, + "description": "Emoji associated with the sticker; only for just uploaded stickers", + "html_description": "Emoji associated with the sticker; only for just uploaded stickers", + "rst_description": "Emoji associated with the sticker; only for just uploaded stickers\n", + "name": "emoji" + }, { "type": "Boolean", "required": false, @@ -8906,14 +8952,6 @@ "html_description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.\n", "name": "reply_markup" - }, - { - "type": "String", - "required": false, - "description": "Emoji associated with the sticker; only for uploaded stickers", - "html_description": "Emoji associated with the sticker; only for uploaded stickers", - "rst_description": "Emoji associated with the sticker; only for uploaded stickers\n", - "name": "emoji" } ], "category": "methods" @@ -8957,9 +8995,9 @@ { "anchor": "uploadstickerfile", "name": "uploadStickerFile", - "description": "Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.", - "html_description": "

Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.

", - "rst_description": "Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", + "description": "Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.", + "html_description": "

Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.

", + "rst_description": "Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", "annotations": [ { "type": "Integer", @@ -8972,10 +9010,10 @@ { "type": "InputFile", "required": true, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" + "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", + "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", + "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", + "name": "sticker" }, { "type": "String", @@ -8984,14 +9022,6 @@ "html_description": "Format of the sticker, must be one of “static”, “animated”, “video”", "rst_description": "Format of the sticker, must be one of 'static', 'animated', 'video'\n", "name": "sticker_format" - }, - { - "type": "InputFile", - "required": true, - "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", - "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", - "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", - "name": "sticker" } ], "category": "methods" @@ -8999,9 +9029,9 @@ { "anchor": "createnewstickerset", "name": "createNewStickerSet", - "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.", - "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.

", - "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success.", + "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.", + "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.

", + "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -9027,62 +9057,6 @@ "rst_description": "Sticker set title, 1-64 characters\n", "name": "title" }, - { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": false, - "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", - "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", - "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", - "name": "sticker_type" - }, - { - "type": "String", - "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" - }, - { - "type": "Boolean", - "required": false, - "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", - "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", - "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", - "name": "needs_repainting" - }, { "type": "Array of InputSticker", "required": true, @@ -9098,6 +9072,22 @@ "html_description": "Format of stickers in the set, must be one of “static”, “animated”, “video”", "rst_description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'\n", "name": "sticker_format" + }, + { + "type": "String", + "required": false, + "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", + "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", + "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", + "name": "sticker_type" + }, + { + "type": "Boolean", + "required": false, + "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", + "name": "needs_repainting" } ], "category": "methods" @@ -9105,9 +9095,9 @@ { "anchor": "addstickertoset", "name": "addStickerToSet", - "description": "Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", - "html_description": "

Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", - "rst_description": "Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", + "description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", + "html_description": "

Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", + "rst_description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -9125,46 +9115,6 @@ "rst_description": "Sticker set name\n", "name": "name" }, - { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" - }, { "type": "InputSticker", "required": true, @@ -9221,11 +9171,115 @@ "category": "methods" }, { - "anchor": "setstickersetthumb", - "name": "setStickerSetThumb", - "description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success.", + "anchor": "setstickeremojilist", + "name": "setStickerEmojiList", + "description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": true, + "description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "html_description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "rst_description": "A JSON-serialized list of 1-20 emoji associated with the sticker\n", + "name": "emoji_list" + } + ], + "category": "methods" + }, + { + "anchor": "setstickerkeywords", + "name": "setStickerKeywords", + "description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": false, + "description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "html_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "rst_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters\n", + "name": "keywords" + } + ], + "category": "methods" + }, + { + "anchor": "setstickermaskposition", + "name": "setStickerMaskPosition", + "description": "Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "MaskPosition", + "required": false, + "description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "html_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "rst_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.\n", + "name": "mask_position" + } + ], + "category": "methods" + }, + { + "anchor": "setstickersettitle", + "name": "setStickerSetTitle", + "description": "Use this method to set the title of a created sticker set. Returns True on success.", + "html_description": "

Use this method to set the title of a created sticker set. Returns True on success.

", + "rst_description": "Use this method to set the title of a created sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": true, + "description": "Sticker set title, 1-64 characters", + "html_description": "Sticker set title, 1-64 characters", + "rst_description": "Sticker set title, 1-64 characters\n", + "name": "title" + } + ], + "category": "methods" + }, + { + "anchor": "setstickersetthumbnail", + "name": "setStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success.", "annotations": [ { "type": "String", @@ -9246,10 +9300,54 @@ { "type": "InputFile or String", "required": false, - "description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "html_description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "rst_description": "A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.\n", - "name": "thumb" + "description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "html_description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "rst_description": "A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.\n", + "name": "thumbnail" + } + ], + "category": "methods" + }, + { + "anchor": "setcustomemojistickersetthumbnail", + "name": "setCustomEmojiStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": false, + "description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "html_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "rst_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.\n", + "name": "custom_emoji_id" + } + ], + "category": "methods" + }, + { + "anchor": "deletestickerset", + "name": "deleteStickerSet", + "description": "Use this method to delete a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to delete a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" } ], "category": "methods" @@ -9465,30 +9563,6 @@ "name": "description", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", @@ -9552,7 +9626,7 @@ "description": "URL of the thumbnail for the photo", "html_description": "URL of the thumbnail for the photo", "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9626,14 +9700,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the photo\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "URL of the thumbnail for the photo", - "html_description": "URL of the thumbnail for the photo", - "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" @@ -9698,7 +9764,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9706,7 +9772,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -9756,22 +9822,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the GIF animation\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", - "html_description": "Optional. MIME type of the thumbnail. Must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", - "rst_description": "*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumbnail_mime_type", - "required": false - }, - { - "type": "String", - "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" @@ -9836,7 +9886,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9844,7 +9894,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -9894,22 +9944,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the video animation\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", - "html_description": "Optional. MIME type of the thumbnail. Must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", - "rst_description": "*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumbnail_mime_type", - "required": false - }, - { - "type": "String", - "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" @@ -9958,7 +9992,7 @@ "description": "URL of the thumbnail (JPEG only) for the video", "html_description": "URL of the thumbnail (JPEG only) for the video", "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -10040,14 +10074,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the video. This field is **required** if InlineQueryResultVideo is used to send an HTML-page as a result (e.g., a YouTube video).\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "URL of the thumbnail (JPEG only) for the video", - "html_description": "URL of the thumbnail (JPEG only) for the video", - "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" @@ -10335,30 +10361,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "URL of the thumbnail (JPEG only) for the file", - "html_description": "Optional. URL of the thumbnail (JPEG only) for the file", - "rst_description": "*Optional*. URL of the thumbnail (JPEG only) for the file\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "URL of the thumbnail (JPEG only) for the file", @@ -10481,30 +10483,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", @@ -10635,30 +10613,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", @@ -10757,30 +10711,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", @@ -13762,360 +13692,6 @@ } ], "description": "Your bot can offer users HTML5 games to play solo or to compete against each other in groups and one-on-one chats. Create games via @BotFather using the /newgame command. Please note that this kind of power requires responsibility: you will need to accept the terms for each game that your bots will be offering.\n - Games are a new type of content on Telegram, represented by the Game and InlineQueryResultGame objects.\n - Once you've created a game via BotFather, you can send games to chats as regular messages using the sendGame method, or use inline mode with InlineQueryResultGame.\n - If you send the game message without any buttons, it will automatically have a 'Play GameName' button. When this button is pressed, your bot gets a CallbackQuery with the game_short_name of the requested game. You provide the correct URL for this particular user and the app opens the game in the in-app browser.\n - You can manually add multiple buttons to your game message. Please note that the first button in the first row must always launch the game, using the field callback_game in InlineKeyboardButton. You can add extra buttons according to taste: e.g., for a description of the rules, or to open the game's official community.\n - To make your game more attractive, you can upload a GIF animation that demostrates the game to the users via BotFather (see Lumberjack for example).\n - A game message will also display high scores for the current chat. Use setGameScore to post high scores to the chat with the game, add the edit_message parameter to automatically update the message with the current scoreboard.\n - Use getGameHighScores to get data for in-game high score tables.\n - You can also add an extra sharing button for users to share their best score to different chats.\n - For examples of what can be done using this new stuff, check the @gamebot and @gamee bots." - }, - { - "title": "Upcoming update", - "anchor": "upcoming-update", - "children": [ - { - "anchor": "setmydescription", - "name": "setMyDescription", - "description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.", - "html_description": "

Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.

", - "rst_description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": false, - "description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", - "html_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", - "rst_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.\n", - "name": "description" - }, - { - "type": "String", - "required": false, - "description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", - "html_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", - "rst_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.\n", - "name": "language_code" - } - ], - "category": "methods" - }, - { - "anchor": "getmydescription", - "name": "getMyDescription", - "description": "Use this method to get the current bot description for the given user language. Returns BotDescription on success.", - "html_description": "

Use this method to get the current bot description for the given user language. Returns BotDescription on success.

", - "rst_description": "Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success.", - "annotations": [ - { - "type": "String", - "required": false, - "description": "A two-letter ISO 639-1 language code or an empty string", - "html_description": "A two-letter ISO 639-1 language code or an empty string", - "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", - "name": "language_code" - } - ], - "category": "methods" - }, - { - "anchor": "botdescription", - "name": "BotDescription", - "description": "This object represents the bot's description.", - "html_description": "

This object represents the bot's description.

", - "rst_description": "This object represents the bot's description.", - "annotations": [ - { - "type": "String", - "description": "The bot's description", - "html_description": "The bot's description", - "rst_description": "The bot's description\n", - "name": "description", - "required": true - } - ], - "category": "types" - }, - { - "anchor": "setmyshortdescription", - "name": "setMyShortDescription", - "description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.", - "html_description": "

Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.

", - "rst_description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": false, - "description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", - "html_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", - "rst_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.\n", - "name": "short_description" - }, - { - "type": "String", - "required": false, - "description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", - "html_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", - "rst_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.\n", - "name": "language_code" - } - ], - "category": "methods" - }, - { - "anchor": "getmyshortdescription", - "name": "getMyShortDescription", - "description": "Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.", - "html_description": "

Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.

", - "rst_description": "Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success.", - "annotations": [ - { - "type": "String", - "required": false, - "description": "A two-letter ISO 639-1 language code or an empty string", - "html_description": "A two-letter ISO 639-1 language code or an empty string", - "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", - "name": "language_code" - } - ], - "category": "methods" - }, - { - "anchor": "botshortdescription", - "name": "BotShortDescription", - "description": "This object represents the bot's short description.", - "html_description": "

This object represents the bot's short description.

", - "rst_description": "This object represents the bot's short description.", - "annotations": [ - { - "type": "String", - "description": "The bot's short description", - "html_description": "The bot's short description", - "rst_description": "The bot's short description\n", - "name": "short_description", - "required": true - } - ], - "category": "types" - }, - { - "anchor": "inputsticker", - "name": "InputSticker", - "description": "This object describes a sticker to be added to a sticker set.", - "html_description": "

This object describes a sticker to be added to a sticker set.

", - "rst_description": "This object describes a sticker to be added to a sticker set.", - "annotations": [ - { - "type": "InputFile or String", - "description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files", - "html_description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files »", - "rst_description": "The added sticker. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `\n", - "name": "sticker", - "required": true - }, - { - "type": "Array of String", - "description": "List of 1-20 emoji associated with the sticker", - "html_description": "List of 1-20 emoji associated with the sticker", - "rst_description": "List of 1-20 emoji associated with the sticker\n", - "name": "emoji_list", - "required": true - }, - { - "type": "MaskPosition", - "description": "Position where the mask should be placed on faces. For 'mask' stickers only.", - "html_description": "Optional. Position where the mask should be placed on faces. For “mask” stickers only.", - "rst_description": "*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.\n", - "name": "mask_position", - "required": false - }, - { - "type": "Array of String", - "description": "List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.", - "html_description": "Optional. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For “regular” and “custom_emoji” stickers only.", - "rst_description": "*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.\n", - "name": "keywords", - "required": false - } - ], - "category": "types" - }, - { - "anchor": "setstickeremojilist", - "name": "setStickerEmojiList", - "description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", - "html_description": "

Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", - "rst_description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "File identifier of the sticker", - "html_description": "File identifier of the sticker", - "rst_description": "File identifier of the sticker\n", - "name": "sticker" - }, - { - "type": "Array of String", - "required": true, - "description": "A JSON-serialized list of 1-20 emoji associated with the sticker", - "html_description": "A JSON-serialized list of 1-20 emoji associated with the sticker", - "rst_description": "A JSON-serialized list of 1-20 emoji associated with the sticker\n", - "name": "emoji_list" - } - ], - "category": "methods" - }, - { - "anchor": "setstickerkeywords", - "name": "setStickerKeywords", - "description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", - "html_description": "

Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", - "rst_description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "File identifier of the sticker", - "html_description": "File identifier of the sticker", - "rst_description": "File identifier of the sticker\n", - "name": "sticker" - }, - { - "type": "Array of String", - "required": false, - "description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", - "html_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", - "rst_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters\n", - "name": "keywords" - } - ], - "category": "methods" - }, - { - "anchor": "setstickermaskposition", - "name": "setStickerMaskPosition", - "description": "Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.", - "html_description": "

Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.

", - "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "File identifier of the sticker", - "html_description": "File identifier of the sticker", - "rst_description": "File identifier of the sticker\n", - "name": "sticker" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", - "html_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", - "rst_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.\n", - "name": "mask_position" - } - ], - "category": "methods" - }, - { - "anchor": "setstickersettitle", - "name": "setStickerSetTitle", - "description": "Use this method to set the title of a created sticker set. Returns True on success.", - "html_description": "

Use this method to set the title of a created sticker set. Returns True on success.

", - "rst_description": "Use this method to set the title of a created sticker set. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - }, - { - "type": "String", - "required": true, - "description": "Sticker set title, 1-64 characters", - "html_description": "Sticker set title, 1-64 characters", - "rst_description": "Sticker set title, 1-64 characters\n", - "name": "title" - } - ], - "category": "methods" - }, - { - "anchor": "deletestickerset", - "name": "deleteStickerSet", - "description": "Use this method to delete a sticker set that was created by the bot. Returns True on success.", - "html_description": "

Use this method to delete a sticker set that was created by the bot. Returns True on success.

", - "rst_description": "Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - } - ], - "category": "methods" - }, - { - "anchor": "setstickersetthumbnail", - "name": "setStickerSetThumbnail", - "description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - }, - { - "type": "Integer", - "required": true, - "description": "User identifier of the sticker set owner", - "html_description": "User identifier of the sticker set owner", - "rst_description": "User identifier of the sticker set owner\n", - "name": "user_id" - }, - { - "type": "InputFile or String", - "required": false, - "description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", - "html_description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", - "rst_description": "A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.\n", - "name": "thumbnail" - } - ], - "category": "methods" - }, - { - "anchor": "setcustomemojistickersetthumbnail", - "name": "setCustomEmojiStickerSetThumbnail", - "description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - }, - { - "type": "String", - "required": false, - "description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", - "html_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", - "rst_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.\n", - "name": "custom_emoji_id" - } - ], - "category": "methods" - } - ] } ] } diff --git a/.butcher/types/Animation/entity.json b/.butcher/types/Animation/entity.json index a6425c10..db471f53 100644 --- a/.butcher/types/Animation/entity.json +++ b/.butcher/types/Animation/entity.json @@ -58,7 +58,7 @@ "description": "Animation thumbnail as defined by sender", "html_description": "Optional. Animation thumbnail as defined by sender", "rst_description": "*Optional*. Animation thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -84,14 +84,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Animation thumbnail as defined by the sender", - "html_description": "Optional. Animation thumbnail as defined by the sender", - "rst_description": "*Optional*. Animation thumbnail as defined by the sender\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/Audio/entity.json b/.butcher/types/Audio/entity.json index 6c536d67..c65b9118 100644 --- a/.butcher/types/Audio/entity.json +++ b/.butcher/types/Audio/entity.json @@ -77,14 +77,6 @@ "name": "file_size", "required": false }, - { - "type": "PhotoSize", - "description": "Thumbnail of the album cover to which the music file belongs", - "html_description": "Optional. Thumbnail of the album cover to which the music file belongs", - "rst_description": "*Optional*. Thumbnail of the album cover to which the music file belongs\n", - "name": "thumb", - "required": false - }, { "type": "PhotoSize", "description": "Thumbnail of the album cover to which the music file belongs", diff --git a/.butcher/types/BotDescription/entity.json b/.butcher/types/BotDescription/entity.json index 107090b4..6d47a69d 100644 --- a/.butcher/types/BotDescription/entity.json +++ b/.butcher/types/BotDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available types", + "anchor": "available-types" }, "object": { "anchor": "botdescription", diff --git a/.butcher/types/BotShortDescription/entity.json b/.butcher/types/BotShortDescription/entity.json index a070f1d9..dcd3e80c 100644 --- a/.butcher/types/BotShortDescription/entity.json +++ b/.butcher/types/BotShortDescription/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Available types", + "anchor": "available-types" }, "object": { "anchor": "botshortdescription", diff --git a/.butcher/types/Document/entity.json b/.butcher/types/Document/entity.json index c24a83f3..036df2c4 100644 --- a/.butcher/types/Document/entity.json +++ b/.butcher/types/Document/entity.json @@ -34,7 +34,7 @@ "description": "Document thumbnail as defined by sender", "html_description": "Optional. Document thumbnail as defined by sender", "rst_description": "*Optional*. Document thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -60,14 +60,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Document thumbnail as defined by the sender", - "html_description": "Optional. Document thumbnail as defined by the sender", - "rst_description": "*Optional*. Document thumbnail as defined by the sender\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/InlineQueryResultArticle/entity.json b/.butcher/types/InlineQueryResultArticle/entity.json index 65d92631..74b635ff 100644 --- a/.butcher/types/InlineQueryResultArticle/entity.json +++ b/.butcher/types/InlineQueryResultArticle/entity.json @@ -77,30 +77,6 @@ "name": "description", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", diff --git a/.butcher/types/InlineQueryResultContact/entity.json b/.butcher/types/InlineQueryResultContact/entity.json index d457688e..2445e5d7 100644 --- a/.butcher/types/InlineQueryResultContact/entity.json +++ b/.butcher/types/InlineQueryResultContact/entity.json @@ -77,30 +77,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", diff --git a/.butcher/types/InlineQueryResultDocument/entity.json b/.butcher/types/InlineQueryResultDocument/entity.json index 1270b5ec..1eda8583 100644 --- a/.butcher/types/InlineQueryResultDocument/entity.json +++ b/.butcher/types/InlineQueryResultDocument/entity.json @@ -101,30 +101,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "URL of the thumbnail (JPEG only) for the file", - "html_description": "Optional. URL of the thumbnail (JPEG only) for the file", - "rst_description": "*Optional*. URL of the thumbnail (JPEG only) for the file\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "URL of the thumbnail (JPEG only) for the file", diff --git a/.butcher/types/InlineQueryResultGif/entity.json b/.butcher/types/InlineQueryResultGif/entity.json index e5078054..b6ab8d8f 100644 --- a/.butcher/types/InlineQueryResultGif/entity.json +++ b/.butcher/types/InlineQueryResultGif/entity.json @@ -66,7 +66,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -74,7 +74,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -124,22 +124,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the GIF animation\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", - "html_description": "Optional. MIME type of the thumbnail. Must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", - "rst_description": "*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumbnail_mime_type", - "required": false - }, - { - "type": "String", - "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" diff --git a/.butcher/types/InlineQueryResultLocation/entity.json b/.butcher/types/InlineQueryResultLocation/entity.json index 1d8633d5..c4cdf8e7 100644 --- a/.butcher/types/InlineQueryResultLocation/entity.json +++ b/.butcher/types/InlineQueryResultLocation/entity.json @@ -101,30 +101,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", diff --git a/.butcher/types/InlineQueryResultMpeg4Gif/entity.json b/.butcher/types/InlineQueryResultMpeg4Gif/entity.json index 232ae722..69916a5b 100644 --- a/.butcher/types/InlineQueryResultMpeg4Gif/entity.json +++ b/.butcher/types/InlineQueryResultMpeg4Gif/entity.json @@ -66,7 +66,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -74,7 +74,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -124,22 +124,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the video animation\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", - "html_description": "Optional. MIME type of the thumbnail. Must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", - "rst_description": "*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumbnail_mime_type", - "required": false - }, - { - "type": "String", - "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", - "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" diff --git a/.butcher/types/InlineQueryResultPhoto/entity.json b/.butcher/types/InlineQueryResultPhoto/entity.json index ee9d45e2..a216aacf 100644 --- a/.butcher/types/InlineQueryResultPhoto/entity.json +++ b/.butcher/types/InlineQueryResultPhoto/entity.json @@ -42,7 +42,7 @@ "description": "URL of the thumbnail for the photo", "html_description": "URL of the thumbnail for the photo", "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -116,14 +116,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the photo\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "URL of the thumbnail for the photo", - "html_description": "URL of the thumbnail for the photo", - "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" diff --git a/.butcher/types/InlineQueryResultVenue/entity.json b/.butcher/types/InlineQueryResultVenue/entity.json index 12233187..3bf6bebe 100644 --- a/.butcher/types/InlineQueryResultVenue/entity.json +++ b/.butcher/types/InlineQueryResultVenue/entity.json @@ -109,30 +109,6 @@ "name": "input_message_content", "required": false }, - { - "type": "String", - "description": "Url of the thumbnail for the result", - "html_description": "Optional. Url of the thumbnail for the result", - "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail width", - "html_description": "Optional. Thumbnail width", - "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", - "required": false - }, - { - "type": "Integer", - "description": "Thumbnail height", - "html_description": "Optional. Thumbnail height", - "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", - "required": false - }, { "type": "String", "description": "Url of the thumbnail for the result", diff --git a/.butcher/types/InlineQueryResultVideo/entity.json b/.butcher/types/InlineQueryResultVideo/entity.json index 306c826c..abc82746 100644 --- a/.butcher/types/InlineQueryResultVideo/entity.json +++ b/.butcher/types/InlineQueryResultVideo/entity.json @@ -50,7 +50,7 @@ "description": "URL of the thumbnail (JPEG only) for the video", "html_description": "URL of the thumbnail (JPEG only) for the video", "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -132,14 +132,6 @@ "rst_description": "*Optional*. Content of the message to be sent instead of the video. This field is **required** if InlineQueryResultVideo is used to send an HTML-page as a result (e.g., a YouTube video).\n", "name": "input_message_content", "required": false - }, - { - "type": "String", - "description": "URL of the thumbnail (JPEG only) for the video", - "html_description": "URL of the thumbnail (JPEG only) for the video", - "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumbnail_url", - "required": true } ], "category": "types" diff --git a/.butcher/types/InputMediaAnimation/entity.json b/.butcher/types/InputMediaAnimation/entity.json index 0f25aabf..4d694d1b 100644 --- a/.butcher/types/InputMediaAnimation/entity.json +++ b/.butcher/types/InputMediaAnimation/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -92,14 +92,6 @@ "rst_description": "*Optional*. Pass :code:`True` if the animation needs to be covered with a spoiler animation\n", "name": "has_spoiler", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/InputMediaAudio/entity.json b/.butcher/types/InputMediaAudio/entity.json index 570642e4..e16a0a7d 100644 --- a/.butcher/types/InputMediaAudio/entity.json +++ b/.butcher/types/InputMediaAudio/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -84,14 +84,6 @@ "rst_description": "*Optional*. Title of the audio\n", "name": "title", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/InputMediaDocument/entity.json b/.butcher/types/InputMediaDocument/entity.json index 0b50c1b4..97bcbcd3 100644 --- a/.butcher/types/InputMediaDocument/entity.json +++ b/.butcher/types/InputMediaDocument/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -68,14 +68,6 @@ "rst_description": "*Optional*. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :code:`True`, if the document is sent as part of an album.\n", "name": "disable_content_type_detection", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/InputMediaVideo/entity.json b/.butcher/types/InputMediaVideo/entity.json index 724c423d..1f5e6487 100644 --- a/.butcher/types/InputMediaVideo/entity.json +++ b/.butcher/types/InputMediaVideo/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -100,14 +100,6 @@ "rst_description": "*Optional*. Pass :code:`True` if the video needs to be covered with a spoiler animation\n", "name": "has_spoiler", "required": false - }, - { - "type": "InputFile or String", - "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", - "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", - "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/InputSticker/entity.json b/.butcher/types/InputSticker/entity.json index da91b91f..819f81f9 100644 --- a/.butcher/types/InputSticker/entity.json +++ b/.butcher/types/InputSticker/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Upcoming update", - "anchor": "upcoming-update" + "title": "Stickers", + "anchor": "stickers" }, "object": { "anchor": "inputsticker", diff --git a/.butcher/types/Sticker/entity.json b/.butcher/types/Sticker/entity.json index 65c3602f..cd3d092b 100644 --- a/.butcher/types/Sticker/entity.json +++ b/.butcher/types/Sticker/entity.json @@ -74,7 +74,7 @@ "description": "Sticker thumbnail in the .WEBP or .JPG format", "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -117,22 +117,6 @@ "name": "custom_emoji_id", "required": false }, - { - "type": "Integer", - "description": "File size in bytes", - "html_description": "Optional. File size in bytes", - "rst_description": "*Optional*. File size in bytes\n", - "name": "file_size", - "required": false - }, - { - "type": "PhotoSize", - "description": "Sticker thumbnail in the .WEBP or .JPG format", - "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", - "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumbnail", - "required": false - }, { "type": "True", "description": "True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", @@ -140,6 +124,14 @@ "rst_description": "*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places\n", "name": "needs_repainting", "required": false + }, + { + "type": "Integer", + "description": "File size in bytes", + "html_description": "Optional. File size in bytes", + "rst_description": "*Optional*. File size in bytes\n", + "name": "file_size", + "required": false } ], "category": "types" diff --git a/.butcher/types/StickerSet/entity.json b/.butcher/types/StickerSet/entity.json index 2dd22632..b766cd7d 100644 --- a/.butcher/types/StickerSet/entity.json +++ b/.butcher/types/StickerSet/entity.json @@ -61,14 +61,6 @@ "name": "stickers", "required": true }, - { - "type": "PhotoSize", - "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", - "html_description": "Optional. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", - "rst_description": "*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format\n", - "name": "thumb", - "required": false - }, { "type": "PhotoSize", "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", diff --git a/.butcher/types/Video/entity.json b/.butcher/types/Video/entity.json index 8e09362c..52bb1439 100644 --- a/.butcher/types/Video/entity.json +++ b/.butcher/types/Video/entity.json @@ -58,7 +58,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -84,14 +84,6 @@ "rst_description": "*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Video thumbnail", - "html_description": "Optional. Video thumbnail", - "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/.butcher/types/VideoNote/entity.json b/.butcher/types/VideoNote/entity.json index 4ba54d94..a27d9a7d 100644 --- a/.butcher/types/VideoNote/entity.json +++ b/.butcher/types/VideoNote/entity.json @@ -50,7 +50,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -60,14 +60,6 @@ "rst_description": "*Optional*. File size in bytes\n", "name": "file_size", "required": false - }, - { - "type": "PhotoSize", - "description": "Video thumbnail", - "html_description": "Optional. Video thumbnail", - "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumbnail", - "required": false } ], "category": "types" diff --git a/aiogram/client/bot.py b/aiogram/client/bot.py index 6dce7196..fe5423c2 100644 --- a/aiogram/client/bot.py +++ b/aiogram/client/bot.py @@ -46,6 +46,7 @@ from ..methods import ( DeleteMessage, DeleteMyCommands, DeleteStickerFromSet, + DeleteStickerSet, DeleteWebhook, EditChatInviteLink, EditForumTopic, @@ -69,6 +70,8 @@ from ..methods import ( GetMe, GetMyCommands, GetMyDefaultAdministratorRights, + GetMyDescription, + GetMyShortDescription, GetStickerSet, GetUpdates, GetUserProfilePhotos, @@ -107,12 +110,20 @@ from ..methods import ( SetChatPhoto, SetChatStickerSet, SetChatTitle, + SetCustomEmojiStickerSetThumbnail, SetGameScore, SetMyCommands, SetMyDefaultAdministratorRights, + SetMyDescription, + SetMyShortDescription, SetPassportDataErrors, + SetStickerEmojiList, + SetStickerKeywords, + SetStickerMaskPosition, SetStickerPositionInSet, SetStickerSetThumb, + SetStickerSetThumbnail, + SetStickerSetTitle, SetWebhook, StopMessageLiveLocation, StopPoll, @@ -124,22 +135,13 @@ from ..methods import ( UnpinAllForumTopicMessages, UnpinChatMessage, UploadStickerFile, - SetStickerSetTitle, - SetStickerSetThumbnail, - SetStickerMaskPosition, - SetStickerKeywords, - SetStickerEmojiList, - SetMyShortDescription, - SetMyDescription, - SetCustomEmojiStickerSetThumbnail, - GetMyShortDescription, - GetMyDescription, - DeleteStickerSet, ) from ..types import ( UNSET, BotCommand, BotCommandScope, + BotDescription, + BotShortDescription, Chat, ChatAdministratorRights, ChatInviteLink, @@ -163,6 +165,7 @@ from ..types import ( InputMediaDocument, InputMediaPhoto, InputMediaVideo, + InputSticker, LabeledPrice, MaskPosition, MenuButtonCommands, @@ -183,9 +186,6 @@ from ..types import ( User, UserProfilePhotos, WebhookInfo, - InputSticker, - BotShortDescription, - BotDescription, ) from .session.aiohttp import AiohttpSession from .session.base import BaseSession @@ -410,27 +410,17 @@ class Bot(ContextInstanceMixin["Bot"]): self, user_id: int, name: str, - emojis: str, sticker: InputSticker, - png_sticker: Optional[Union[InputFile, str]] = None, - tgs_sticker: Optional[InputFile] = None, - webm_sticker: Optional[InputFile] = None, - mask_position: Optional[MaskPosition] = None, request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. + Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#addstickertoset :param user_id: User identifier of sticker set owner :param name: Sticker set name - :param emojis: One or more emoji corresponding to the sticker :param sticker: A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed. - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param tgs_sticker: **TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements - :param webm_sticker: **WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements - :param mask_position: A JSON-serialized object for position where the mask should be placed on faces :param request_timeout: Request timeout :return: Returns :code:`True` on success. """ @@ -438,12 +428,7 @@ class Bot(ContextInstanceMixin["Bot"]): call = AddStickerToSet( user_id=user_id, name=name, - emojis=emojis, sticker=sticker, - png_sticker=png_sticker, - tgs_sticker=tgs_sticker, - webm_sticker=webm_sticker, - mask_position=mask_position, ) return await self(call, request_timeout=request_timeout) @@ -911,33 +896,23 @@ class Bot(ContextInstanceMixin["Bot"]): user_id: int, name: str, title: str, - emojis: str, stickers: List[InputSticker], sticker_format: str, - png_sticker: Optional[Union[InputFile, str]] = None, - tgs_sticker: Optional[InputFile] = None, - webm_sticker: Optional[InputFile] = None, sticker_type: Optional[str] = None, - mask_position: Optional[MaskPosition] = None, needs_repainting: Optional[bool] = None, request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success. + Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#createnewstickerset :param user_id: User identifier of created sticker set owner :param name: Short name of sticker set, to be used in :code:`t.me/addstickers/` URLs (e.g., *animals*). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters. :param title: Sticker set title, 1-64 characters - :param emojis: One or more emoji corresponding to the sticker :param stickers: A JSON-serialized list of 1-50 initial stickers to be added to the sticker set :param sticker_format: Format of stickers in the set, must be one of 'static', 'animated', 'video' - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param tgs_sticker: **TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements - :param webm_sticker: **WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements :param sticker_type: Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created. - :param mask_position: A JSON-serialized object for position where the mask should be placed on faces :param needs_repainting: Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only :param request_timeout: Request timeout :return: Returns :code:`True` on success. @@ -947,14 +922,9 @@ class Bot(ContextInstanceMixin["Bot"]): user_id=user_id, name=name, title=title, - emojis=emojis, stickers=stickers, sticker_format=sticker_format, - png_sticker=png_sticker, - tgs_sticker=tgs_sticker, - webm_sticker=webm_sticker, sticker_type=sticker_type, - mask_position=mask_position, needs_repainting=needs_repainting, ) return await self(call, request_timeout=request_timeout) @@ -2024,7 +1994,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2036,7 +2006,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2050,7 +2019,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -2060,7 +2029,6 @@ class Bot(ContextInstanceMixin["Bot"]): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param request_timeout: Request timeout :return: Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. """ @@ -2072,7 +2040,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2082,7 +2050,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, ) return await self(call, request_timeout=request_timeout) @@ -2097,7 +2064,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2105,7 +2072,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2123,13 +2089,12 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param request_timeout: Request timeout :return: Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. """ @@ -2144,13 +2109,12 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, ) return await self(call, request_timeout=request_timeout) @@ -2284,7 +2248,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id: Union[int, str], document: Union[InputFile, str], message_thread_id: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2296,7 +2260,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2307,7 +2270,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -2317,7 +2280,6 @@ class Bot(ContextInstanceMixin["Bot"]): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param request_timeout: Request timeout :return: Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. """ @@ -2326,7 +2288,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id=chat_id, document=document, message_thread_id=message_thread_id, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2336,7 +2298,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, ) return await self(call, request_timeout=request_timeout) @@ -2766,6 +2727,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id: Union[int, str], sticker: Union[InputFile, str], message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2773,7 +2735,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - emoji: Optional[str] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2784,12 +2745,12 @@ class Bot(ContextInstanceMixin["Bot"]): :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param emoji: Emoji associated with the sticker; only for uploaded stickers :param request_timeout: Request timeout :return: On success, the sent :class:`aiogram.types.message.Message` is returned. """ @@ -2798,12 +2759,12 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id=chat_id, sticker=sticker, message_thread_id=message_thread_id, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - emoji=emoji, ) return await self(call, request_timeout=request_timeout) @@ -2879,7 +2840,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2892,7 +2853,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2906,7 +2866,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -2917,7 +2877,6 @@ class Bot(ContextInstanceMixin["Bot"]): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param request_timeout: Request timeout :return: Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. """ @@ -2929,7 +2888,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2940,7 +2899,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, ) return await self(call, request_timeout=request_timeout) @@ -2951,7 +2909,7 @@ class Bot(ContextInstanceMixin["Bot"]): message_thread_id: Optional[int] = None, duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2959,7 +2917,6 @@ class Bot(ContextInstanceMixin["Bot"]): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, request_timeout: Optional[int] = None, ) -> Message: """ @@ -2972,13 +2929,12 @@ class Bot(ContextInstanceMixin["Bot"]): :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param request_timeout: Request timeout :return: On success, the sent :class:`aiogram.types.message.Message` is returned. """ @@ -2989,13 +2945,12 @@ class Bot(ContextInstanceMixin["Bot"]): message_thread_id=message_thread_id, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, ) return await self(call, request_timeout=request_timeout) @@ -3294,7 +3249,7 @@ class Bot(ContextInstanceMixin["Bot"]): request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success. + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights @@ -3604,29 +3559,26 @@ class Bot(ContextInstanceMixin["Bot"]): async def upload_sticker_file( self, user_id: int, - png_sticker: InputFile, - sticker_format: str, sticker: InputFile, + sticker_format: str, request_timeout: Optional[int] = None, ) -> File: """ - Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. Source: https://core.telegram.org/bots/api#uploadstickerfile :param user_id: User identifier of sticker file owner - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » ` - :param sticker_format: Format of the sticker, must be one of 'static', 'animated', 'video' :param sticker: A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » ` + :param sticker_format: Format of the sticker, must be one of 'static', 'animated', 'video' :param request_timeout: Request timeout :return: Returns the uploaded :class:`aiogram.types.file.File` on success. """ call = UploadStickerFile( user_id=user_id, - png_sticker=png_sticker, - sticker_format=sticker_format, sticker=sticker, + sticker_format=sticker_format, ) return await self(call, request_timeout=request_timeout) @@ -3915,7 +3867,7 @@ class Bot(ContextInstanceMixin["Bot"]): request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setstickermaskposition diff --git a/aiogram/enums/__init__.py b/aiogram/enums/__init__.py index 4ced2109..73422378 100644 --- a/aiogram/enums/__init__.py +++ b/aiogram/enums/__init__.py @@ -11,10 +11,10 @@ from .menu_button_type import MenuButtonType from .message_entity_type import MessageEntityType from .parse_mode import ParseMode from .poll_type import PollType +from .sticker_format import StickerFormat from .sticker_type import StickerType from .topic_icon_color import TopicIconColor from .update_type import UpdateType -from .sticker_format import StickerFormat __all__ = ( "BotCommandScopeType", diff --git a/aiogram/methods/__init__.py b/aiogram/methods/__init__.py index fe9bb3a8..5bf0edf5 100644 --- a/aiogram/methods/__init__.py +++ b/aiogram/methods/__init__.py @@ -23,6 +23,7 @@ from .delete_forum_topic import DeleteForumTopic from .delete_message import DeleteMessage from .delete_my_commands import DeleteMyCommands from .delete_sticker_from_set import DeleteStickerFromSet +from .delete_sticker_set import DeleteStickerSet from .delete_webhook import DeleteWebhook from .edit_chat_invite_link import EditChatInviteLink from .edit_forum_topic import EditForumTopic @@ -46,6 +47,8 @@ from .get_game_high_scores import GetGameHighScores from .get_me import GetMe from .get_my_commands import GetMyCommands from .get_my_default_administrator_rights import GetMyDefaultAdministratorRights +from .get_my_description import GetMyDescription +from .get_my_short_description import GetMyShortDescription from .get_sticker_set import GetStickerSet from .get_updates import GetUpdates from .get_user_profile_photos import GetUserProfilePhotos @@ -84,12 +87,19 @@ from .set_chat_permissions import SetChatPermissions from .set_chat_photo import SetChatPhoto from .set_chat_sticker_set import SetChatStickerSet from .set_chat_title import SetChatTitle +from .set_custom_emoji_sticker_set_thumbnail import SetCustomEmojiStickerSetThumbnail from .set_game_score import SetGameScore from .set_my_commands import SetMyCommands from .set_my_default_administrator_rights import SetMyDefaultAdministratorRights +from .set_my_description import SetMyDescription +from .set_my_short_description import SetMyShortDescription from .set_passport_data_errors import SetPassportDataErrors +from .set_sticker_emoji_list import SetStickerEmojiList +from .set_sticker_keywords import SetStickerKeywords +from .set_sticker_mask_position import SetStickerMaskPosition from .set_sticker_position_in_set import SetStickerPositionInSet -from .set_sticker_set_thumb import SetStickerSetThumb +from .set_sticker_set_thumbnail import SetStickerSetThumbnail +from .set_sticker_set_title import SetStickerSetTitle from .set_webhook import SetWebhook from .stop_message_live_location import StopMessageLiveLocation from .stop_poll import StopPoll @@ -100,17 +110,6 @@ from .unpin_all_chat_messages import UnpinAllChatMessages from .unpin_all_forum_topic_messages import UnpinAllForumTopicMessages from .unpin_chat_message import UnpinChatMessage from .upload_sticker_file import UploadStickerFile -from .delete_sticker_set import DeleteStickerSet -from .get_my_description import GetMyDescription -from .get_my_short_description import GetMyShortDescription -from .set_custom_emoji_sticker_set_thumbnail import SetCustomEmojiStickerSetThumbnail -from .set_my_description import SetMyDescription -from .set_my_short_description import SetMyShortDescription -from .set_sticker_emoji_list import SetStickerEmojiList -from .set_sticker_keywords import SetStickerKeywords -from .set_sticker_mask_position import SetStickerMaskPosition -from .set_sticker_set_thumbnail import SetStickerSetThumbnail -from .set_sticker_set_title import SetStickerSetTitle __all__ = ( "AddStickerToSet", @@ -214,7 +213,6 @@ __all__ = ( "SetStickerKeywords", "SetStickerMaskPosition", "SetStickerPositionInSet", - "SetStickerSetThumb", "SetStickerSetThumbnail", "SetStickerSetTitle", "SetWebhook", diff --git a/aiogram/methods/add_sticker_to_set.py b/aiogram/methods/add_sticker_to_set.py index 71c3d3f9..836f18e3 100644 --- a/aiogram/methods/add_sticker_to_set.py +++ b/aiogram/methods/add_sticker_to_set.py @@ -2,7 +2,7 @@ from __future__ import annotations from typing import TYPE_CHECKING, Any, Dict, Optional, Union -from ..types import InputFile, MaskPosition, InputSticker +from ..types import InputFile, InputSticker, MaskPosition from .base import Request, TelegramMethod, prepare_file if TYPE_CHECKING: @@ -11,7 +11,7 @@ if TYPE_CHECKING: class AddStickerToSet(TelegramMethod[bool]): """ - Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. + Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#addstickertoset """ @@ -22,18 +22,8 @@ class AddStickerToSet(TelegramMethod[bool]): """User identifier of sticker set owner""" name: str """Sticker set name""" - emojis: str - """One or more emoji corresponding to the sticker""" sticker: InputSticker """A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.""" - png_sticker: Optional[Union[InputFile, str]] = None - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" - tgs_sticker: Optional[InputFile] = None - """**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements""" - webm_sticker: Optional[InputFile] = None - """**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements""" - mask_position: Optional[MaskPosition] = None - """A JSON-serialized object for position where the mask should be placed on faces""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"png_sticker", "tgs_sticker", "webm_sticker"}) diff --git a/aiogram/methods/create_new_sticker_set.py b/aiogram/methods/create_new_sticker_set.py index de445431..bc1f0fb9 100644 --- a/aiogram/methods/create_new_sticker_set.py +++ b/aiogram/methods/create_new_sticker_set.py @@ -1,8 +1,8 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Any, Dict, Optional, Union, List +from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union -from ..types import InputFile, MaskPosition, InputSticker +from ..types import InputFile, InputSticker, MaskPosition from .base import Request, TelegramMethod, prepare_file if TYPE_CHECKING: @@ -11,7 +11,7 @@ if TYPE_CHECKING: class CreateNewStickerSet(TelegramMethod[bool]): """ - Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success. + Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#createnewstickerset """ @@ -24,22 +24,12 @@ class CreateNewStickerSet(TelegramMethod[bool]): """Short name of sticker set, to be used in :code:`t.me/addstickers/` URLs (e.g., *animals*). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters.""" title: str """Sticker set title, 1-64 characters""" - emojis: str - """One or more emoji corresponding to the sticker""" stickers: List[InputSticker] """A JSON-serialized list of 1-50 initial stickers to be added to the sticker set""" sticker_format: str """Format of stickers in the set, must be one of 'static', 'animated', 'video'""" - png_sticker: Optional[Union[InputFile, str]] = None - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" - tgs_sticker: Optional[InputFile] = None - """**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements""" - webm_sticker: Optional[InputFile] = None - """**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements""" sticker_type: Optional[str] = None """Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.""" - mask_position: Optional[MaskPosition] = None - """A JSON-serialized object for position where the mask should be placed on faces""" needs_repainting: Optional[bool] = None """Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only""" diff --git a/aiogram/methods/send_animation.py b/aiogram/methods/send_animation.py index 0e7d3875..d382edf2 100644 --- a/aiogram/methods/send_animation.py +++ b/aiogram/methods/send_animation.py @@ -39,7 +39,7 @@ class SendAnimation(TelegramMethod[Message]): """Animation width""" height: Optional[int] = None """Animation height""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing""" @@ -61,8 +61,6 @@ class SendAnimation(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - thumbnail: Optional[Union[InputFile, str]] = None - """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"animation", "thumb"}) diff --git a/aiogram/methods/send_audio.py b/aiogram/methods/send_audio.py index 537a39ec..c83c1818 100644 --- a/aiogram/methods/send_audio.py +++ b/aiogram/methods/send_audio.py @@ -46,7 +46,7 @@ class SendAudio(TelegramMethod[Message]): """Performer""" title: Optional[str] = None """Track name""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" @@ -60,8 +60,6 @@ class SendAudio(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - thumbnail: Optional[Union[InputFile, str]] = None - """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"audio", "thumb"}) diff --git a/aiogram/methods/send_document.py b/aiogram/methods/send_document.py index a61e8fa5..919f52f1 100644 --- a/aiogram/methods/send_document.py +++ b/aiogram/methods/send_document.py @@ -33,7 +33,7 @@ class SendDocument(TelegramMethod[Message]): """File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" message_thread_id: Optional[int] = None """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing""" @@ -55,8 +55,6 @@ class SendDocument(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - thumbnail: Optional[Union[InputFile, str]] = None - """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"document", "thumb"}) diff --git a/aiogram/methods/send_sticker.py b/aiogram/methods/send_sticker.py index 42a65c1b..e707cd2f 100644 --- a/aiogram/methods/send_sticker.py +++ b/aiogram/methods/send_sticker.py @@ -31,6 +31,8 @@ class SendSticker(TelegramMethod[Message]): """Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.""" message_thread_id: Optional[int] = None """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + emoji: Optional[str] = None + """Emoji associated with the sticker; only for just uploaded stickers""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" protect_content: Optional[bool] = None @@ -43,8 +45,6 @@ class SendSticker(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - emoji: Optional[str] = None - """Emoji associated with the sticker; only for uploaded stickers""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"sticker"}) diff --git a/aiogram/methods/send_video.py b/aiogram/methods/send_video.py index 3c9a63bc..001c8ccd 100644 --- a/aiogram/methods/send_video.py +++ b/aiogram/methods/send_video.py @@ -39,7 +39,7 @@ class SendVideo(TelegramMethod[Message]): """Video width""" height: Optional[int] = None """Video height""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing""" @@ -63,8 +63,6 @@ class SendVideo(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - thumbnail: Optional[Union[InputFile, str]] = None - """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"video", "thumb"}) diff --git a/aiogram/methods/send_video_note.py b/aiogram/methods/send_video_note.py index 1acea9b1..9de6661f 100644 --- a/aiogram/methods/send_video_note.py +++ b/aiogram/methods/send_video_note.py @@ -35,7 +35,7 @@ class SendVideoNote(TelegramMethod[Message]): """Duration of sent video in seconds""" length: Optional[int] = None """Video width and height, i.e. diameter of the video message""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" @@ -49,8 +49,6 @@ class SendVideoNote(TelegramMethod[Message]): Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user.""" - thumbnail: Optional[Union[InputFile, str]] = None - """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"video_note", "thumb"}) diff --git a/aiogram/methods/set_my_default_administrator_rights.py b/aiogram/methods/set_my_default_administrator_rights.py index 84341180..f8177958 100644 --- a/aiogram/methods/set_my_default_administrator_rights.py +++ b/aiogram/methods/set_my_default_administrator_rights.py @@ -11,7 +11,7 @@ if TYPE_CHECKING: class SetMyDefaultAdministratorRights(TelegramMethod[bool]): """ - Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success. + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights """ diff --git a/aiogram/methods/set_sticker_keywords.py b/aiogram/methods/set_sticker_keywords.py index ca1b5bf2..2fd5b1c4 100644 --- a/aiogram/methods/set_sticker_keywords.py +++ b/aiogram/methods/set_sticker_keywords.py @@ -1,6 +1,6 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Any, Dict, Optional, List +from typing import TYPE_CHECKING, Any, Dict, List, Optional from .base import Request, TelegramMethod diff --git a/aiogram/methods/set_sticker_mask_position.py b/aiogram/methods/set_sticker_mask_position.py index 34f6cafb..95aa8ca3 100644 --- a/aiogram/methods/set_sticker_mask_position.py +++ b/aiogram/methods/set_sticker_mask_position.py @@ -2,8 +2,8 @@ from __future__ import annotations from typing import TYPE_CHECKING, Any, Dict, Optional -from .base import Request, TelegramMethod from ..types import MaskPosition +from .base import Request, TelegramMethod if TYPE_CHECKING: from ..client.bot import Bot @@ -11,7 +11,7 @@ if TYPE_CHECKING: class SetStickerMaskPosition(TelegramMethod[bool]): """ - Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setstickermaskposition """ diff --git a/aiogram/methods/set_sticker_set_thumb.py b/aiogram/methods/set_sticker_set_thumb.py deleted file mode 100644 index cbab57e4..00000000 --- a/aiogram/methods/set_sticker_set_thumb.py +++ /dev/null @@ -1,34 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING, Any, Dict, Optional, Union - -from ..types import InputFile -from .base import Request, TelegramMethod, prepare_file - -if TYPE_CHECKING: - from ..client.bot import Bot - - -class SetStickerSetThumb(TelegramMethod[bool]): - """ - Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success. - - Source: https://core.telegram.org/bots/api#setstickersetthumb - """ - - __returning__ = bool - - name: str - """Sticker set name""" - user_id: int - """User identifier of the sticker set owner""" - thumb: Optional[Union[InputFile, str]] = None - """A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.""" - - def build_request(self, bot: Bot) -> Request: - data: Dict[str, Any] = self.dict(exclude={"thumb"}) - - files: Dict[str, InputFile] = {} - prepare_file(data=data, files=files, name="thumb", value=self.thumb) - - return Request(method="setStickerSetThumb", data=data, files=files) diff --git a/aiogram/methods/set_sticker_set_thumbnail.py b/aiogram/methods/set_sticker_set_thumbnail.py index f347a856..8cc87c2f 100644 --- a/aiogram/methods/set_sticker_set_thumbnail.py +++ b/aiogram/methods/set_sticker_set_thumbnail.py @@ -2,8 +2,8 @@ from __future__ import annotations from typing import TYPE_CHECKING, Any, Dict, Optional, Union -from .base import Request, TelegramMethod from ..types import InputFile +from .base import Request, TelegramMethod if TYPE_CHECKING: from ..client.bot import Bot diff --git a/aiogram/methods/upload_sticker_file.py b/aiogram/methods/upload_sticker_file.py index 0d66f420..501d3161 100644 --- a/aiogram/methods/upload_sticker_file.py +++ b/aiogram/methods/upload_sticker_file.py @@ -11,7 +11,7 @@ if TYPE_CHECKING: class UploadStickerFile(TelegramMethod[File]): """ - Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. Source: https://core.telegram.org/bots/api#uploadstickerfile """ @@ -20,12 +20,10 @@ class UploadStickerFile(TelegramMethod[File]): user_id: int """User identifier of sticker file owner""" - png_sticker: InputFile - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `""" - sticker_format: str - """Format of the sticker, must be one of 'static', 'animated', 'video'""" sticker: InputFile """A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `""" + sticker_format: str + """Format of the sticker, must be one of 'static', 'animated', 'video'""" def build_request(self, bot: Bot) -> Request: data: Dict[str, Any] = self.dict(exclude={"png_sticker"}) diff --git a/aiogram/types/__init__.py b/aiogram/types/__init__.py index 04a9df83..3fc98953 100644 --- a/aiogram/types/__init__.py +++ b/aiogram/types/__init__.py @@ -14,6 +14,8 @@ from .bot_command_scope_chat import BotCommandScopeChat from .bot_command_scope_chat_administrators import BotCommandScopeChatAdministrators from .bot_command_scope_chat_member import BotCommandScopeChatMember from .bot_command_scope_default import BotCommandScopeDefault +from .bot_description import BotDescription +from .bot_short_description import BotShortDescription from .callback_game import CallbackGame from .callback_query import CallbackQuery from .chat import Chat @@ -86,6 +88,7 @@ from .input_media_document import InputMediaDocument from .input_media_photo import InputMediaPhoto from .input_media_video import InputMediaVideo from .input_message_content import InputMessageContent +from .input_sticker import InputSticker from .input_text_message_content import InputTextMessageContent from .input_venue_message_content import InputVenueMessageContent from .invoice import Invoice @@ -152,9 +155,6 @@ from .web_app_data import WebAppData from .web_app_info import WebAppInfo from .webhook_info import WebhookInfo from .write_access_allowed import WriteAccessAllowed -from .bot_description import BotDescription -from .bot_short_description import BotShortDescription -from .input_sticker import InputSticker __all__ = ( "Animation", diff --git a/aiogram/types/animation.py b/aiogram/types/animation.py index bb7a1ef2..15354156 100644 --- a/aiogram/types/animation.py +++ b/aiogram/types/animation.py @@ -25,7 +25,7 @@ class Animation(TelegramObject): """Video height as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Animation thumbnail as defined by sender""" file_name: Optional[str] = None """*Optional*. Original animation filename as defined by sender""" @@ -33,5 +33,3 @@ class Animation(TelegramObject): """*Optional*. MIME type of the file as defined by sender""" file_size: Optional[int] = None """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" - thumbnail: Optional[PhotoSize] = None - """*Optional*. Animation thumbnail as defined by the sender""" diff --git a/aiogram/types/audio.py b/aiogram/types/audio.py index 5dd4f438..0a147c36 100644 --- a/aiogram/types/audio.py +++ b/aiogram/types/audio.py @@ -31,7 +31,5 @@ class Audio(TelegramObject): """*Optional*. MIME type of the file as defined by sender""" file_size: Optional[int] = None """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" - thumb: Optional[PhotoSize] = None - """*Optional*. Thumbnail of the album cover to which the music file belongs""" thumbnail: Optional[PhotoSize] = None """*Optional*. Thumbnail of the album cover to which the music file belongs""" diff --git a/aiogram/types/document.py b/aiogram/types/document.py index 3402373c..837bf4ec 100644 --- a/aiogram/types/document.py +++ b/aiogram/types/document.py @@ -19,7 +19,7 @@ class Document(TelegramObject): """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.""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Document thumbnail as defined by sender""" file_name: Optional[str] = None """*Optional*. Original filename as defined by sender""" @@ -27,5 +27,3 @@ class Document(TelegramObject): """*Optional*. MIME type of the file as defined by sender""" file_size: Optional[int] = None """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" - thumbnail: Optional[PhotoSize] = None - """*Optional*. Document thumbnail as defined by the sender""" diff --git a/aiogram/types/inline_query_result_article.py b/aiogram/types/inline_query_result_article.py index c5bc275f..dd65b595 100644 --- a/aiogram/types/inline_query_result_article.py +++ b/aiogram/types/inline_query_result_article.py @@ -35,12 +35,6 @@ class InlineQueryResultArticle(InlineQueryResult): """*Optional*. Pass :code:`True` if you don't want the URL to be shown in the message""" description: Optional[str] = None """*Optional*. Short description of the result""" - thumb_url: Optional[str] = None - """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None - """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None - """*Optional*. Thumbnail height""" thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" thumbnail_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_contact.py b/aiogram/types/inline_query_result_contact.py index 78b13852..0f88bb9f 100644 --- a/aiogram/types/inline_query_result_contact.py +++ b/aiogram/types/inline_query_result_contact.py @@ -36,12 +36,6 @@ class InlineQueryResultContact(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the contact""" - thumb_url: Optional[str] = None - """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None - """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None - """*Optional*. Thumbnail height""" thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" thumbnail_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_document.py b/aiogram/types/inline_query_result_document.py index cb8f85d3..d1c577cf 100644 --- a/aiogram/types/inline_query_result_document.py +++ b/aiogram/types/inline_query_result_document.py @@ -44,12 +44,6 @@ class InlineQueryResultDocument(InlineQueryResult): """*Optional*. Inline keyboard attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the file""" - thumb_url: Optional[str] = None - """*Optional*. URL of the thumbnail (JPEG only) for the file""" - thumb_width: Optional[int] = None - """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None - """*Optional*. Thumbnail height""" thumbnail_url: Optional[str] = None """*Optional*. URL of the thumbnail (JPEG only) for the file""" thumbnail_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_gif.py b/aiogram/types/inline_query_result_gif.py index 82603ef6..ac4e0c05 100644 --- a/aiogram/types/inline_query_result_gif.py +++ b/aiogram/types/inline_query_result_gif.py @@ -27,8 +27,6 @@ class InlineQueryResultGif(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" gif_url: str """A valid URL for the GIF file. File size must not exceed 1MB""" - thumb_url: str - """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" thumbnail_url: str """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" gif_width: Optional[int] = None @@ -37,7 +35,7 @@ class InlineQueryResultGif(InlineQueryResult): """*Optional*. Height of the GIF""" gif_duration: Optional[int] = None """*Optional*. Duration of the GIF in seconds""" - thumb_mime_type: Optional[str] = None + thumbnail_mime_type: Optional[str] = None """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" title: Optional[str] = None """*Optional*. Title for the result""" @@ -51,5 +49,3 @@ class InlineQueryResultGif(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the GIF animation""" - thumbnail_mime_type: Optional[str] = None - """*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" diff --git a/aiogram/types/inline_query_result_location.py b/aiogram/types/inline_query_result_location.py index 2632c482..aa1f6d88 100644 --- a/aiogram/types/inline_query_result_location.py +++ b/aiogram/types/inline_query_result_location.py @@ -42,12 +42,6 @@ class InlineQueryResultLocation(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the location""" - thumb_url: Optional[str] = None - """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None - """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None - """*Optional*. Thumbnail height""" thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" thumbnail_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_mpeg4_gif.py b/aiogram/types/inline_query_result_mpeg4_gif.py index 6bbdbc73..260ae839 100644 --- a/aiogram/types/inline_query_result_mpeg4_gif.py +++ b/aiogram/types/inline_query_result_mpeg4_gif.py @@ -27,8 +27,6 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" mpeg4_url: str """A valid URL for the MPEG4 file. File size must not exceed 1MB""" - thumb_url: str - """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" thumbnail_url: str """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" mpeg4_width: Optional[int] = None @@ -37,7 +35,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): """*Optional*. Video height""" mpeg4_duration: Optional[int] = None """*Optional*. Video duration in seconds""" - thumb_mime_type: Optional[str] = None + thumbnail_mime_type: Optional[str] = None """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" title: Optional[str] = None """*Optional*. Title for the result""" @@ -51,5 +49,3 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the video animation""" - thumbnail_mime_type: Optional[str] = None - """*Optional*. MIME type of the thumbnail. Must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" diff --git a/aiogram/types/inline_query_result_photo.py b/aiogram/types/inline_query_result_photo.py index 40c9aa1e..6ef09fc3 100644 --- a/aiogram/types/inline_query_result_photo.py +++ b/aiogram/types/inline_query_result_photo.py @@ -27,8 +27,6 @@ class InlineQueryResultPhoto(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" photo_url: str """A valid URL of the photo. Photo must be in **JPEG** format. Photo size must not exceed 5MB""" - thumb_url: str - """URL of the thumbnail for the photo""" thumbnail_url: str """URL of the thumbnail for the photo""" photo_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_venue.py b/aiogram/types/inline_query_result_venue.py index 5493ff1b..0c92a008 100644 --- a/aiogram/types/inline_query_result_venue.py +++ b/aiogram/types/inline_query_result_venue.py @@ -44,12 +44,6 @@ class InlineQueryResultVenue(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the venue""" - thumb_url: Optional[str] = None - """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None - """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None - """*Optional*. Thumbnail height""" thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" thumbnail_width: Optional[int] = None diff --git a/aiogram/types/inline_query_result_video.py b/aiogram/types/inline_query_result_video.py index ad92bbb9..f35c55cb 100644 --- a/aiogram/types/inline_query_result_video.py +++ b/aiogram/types/inline_query_result_video.py @@ -31,12 +31,10 @@ class InlineQueryResultVideo(InlineQueryResult): """A valid URL for the embedded video player or video file""" mime_type: str """MIME type of the content of the video URL, 'text/html' or 'video/mp4'""" - thumb_url: str + thumbnail_url: str """URL of the thumbnail (JPEG only) for the video""" title: str """Title for the result""" - thumbnail_url: str - """URL of the thumbnail (JPEG only) for the video""" caption: Optional[str] = None """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" parse_mode: Optional[str] = UNSET diff --git a/aiogram/types/input_media_animation.py b/aiogram/types/input_media_animation.py index c0f8c25d..9b94f0c1 100644 --- a/aiogram/types/input_media_animation.py +++ b/aiogram/types/input_media_animation.py @@ -24,7 +24,7 @@ class InputMediaAnimation(InputMedia): """Type of the result, must be *animation*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the animation to be sent, 0-1024 characters after entities parsing""" @@ -40,5 +40,3 @@ class InputMediaAnimation(InputMedia): """*Optional*. Animation duration in seconds""" has_spoiler: Optional[bool] = None """*Optional*. Pass :code:`True` if the animation needs to be covered with a spoiler animation""" - thumbnail: Optional[Union[InputFile, str]] = None - """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" diff --git a/aiogram/types/input_media_audio.py b/aiogram/types/input_media_audio.py index 0921731b..3d149dc8 100644 --- a/aiogram/types/input_media_audio.py +++ b/aiogram/types/input_media_audio.py @@ -24,7 +24,7 @@ class InputMediaAudio(InputMedia): """Type of the result, must be *audio*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the audio to be sent, 0-1024 characters after entities parsing""" @@ -38,5 +38,3 @@ class InputMediaAudio(InputMedia): """*Optional*. Performer of the audio""" title: Optional[str] = None """*Optional*. Title of the audio""" - thumbnail: Optional[Union[InputFile, str]] = None - """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" diff --git a/aiogram/types/input_media_document.py b/aiogram/types/input_media_document.py index c7473389..6eb6acfa 100644 --- a/aiogram/types/input_media_document.py +++ b/aiogram/types/input_media_document.py @@ -24,7 +24,7 @@ class InputMediaDocument(InputMedia): """Type of the result, must be *document*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing""" @@ -34,5 +34,3 @@ class InputMediaDocument(InputMedia): """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" disable_content_type_detection: Optional[bool] = None """*Optional*. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :code:`True`, if the document is sent as part of an album.""" - thumbnail: Optional[Union[InputFile, str]] = None - """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" diff --git a/aiogram/types/input_media_video.py b/aiogram/types/input_media_video.py index 65689328..21379d5f 100644 --- a/aiogram/types/input_media_video.py +++ b/aiogram/types/input_media_video.py @@ -24,7 +24,7 @@ class InputMediaVideo(InputMedia): """Type of the result, must be *video*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" @@ -42,5 +42,3 @@ class InputMediaVideo(InputMedia): """*Optional*. Pass :code:`True` if the uploaded video is suitable for streaming""" has_spoiler: Optional[bool] = None """*Optional*. Pass :code:`True` if the video needs to be covered with a spoiler animation""" - thumbnail: Optional[Union[InputFile, str]] = None - """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" diff --git a/aiogram/types/input_sticker.py b/aiogram/types/input_sticker.py index 4ddf7188..46bec15c 100644 --- a/aiogram/types/input_sticker.py +++ b/aiogram/types/input_sticker.py @@ -1,6 +1,6 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Union, List, Optional +from typing import TYPE_CHECKING, List, Optional, Union from .base import TelegramObject diff --git a/aiogram/types/message.py b/aiogram/types/message.py index b2973d9d..bd18740a 100644 --- a/aiogram/types/message.py +++ b/aiogram/types/message.py @@ -348,7 +348,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -359,7 +359,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendAnimation: """ @@ -378,7 +377,7 @@ class Message(TelegramObject): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -387,7 +386,6 @@ class Message(TelegramObject): :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` """ # DO NOT EDIT MANUALLY!!! @@ -403,7 +401,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -412,7 +410,6 @@ class Message(TelegramObject): protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -422,7 +419,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -434,7 +431,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendAnimation: """ @@ -452,7 +448,7 @@ class Message(TelegramObject): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -462,7 +458,6 @@ class Message(TelegramObject): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` """ # DO NOT EDIT MANUALLY!!! @@ -477,7 +472,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -487,7 +482,6 @@ class Message(TelegramObject): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -500,14 +494,13 @@ class Message(TelegramObject): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendAudio: """ @@ -530,12 +523,11 @@ class Message(TelegramObject): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` """ # DO NOT EDIT MANUALLY!!! @@ -554,12 +546,11 @@ class Message(TelegramObject): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -572,7 +563,7 @@ class Message(TelegramObject): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -580,7 +571,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendAudio: """ @@ -602,13 +592,12 @@ class Message(TelegramObject): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` """ # DO NOT EDIT MANUALLY!!! @@ -626,13 +615,12 @@ class Message(TelegramObject): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -752,7 +740,7 @@ class Message(TelegramObject): def reply_document( self, document: Union[InputFile, str], - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -763,7 +751,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendDocument: """ @@ -779,7 +766,7 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#senddocument :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -788,7 +775,6 @@ class Message(TelegramObject): :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_document.SendDocument` """ # DO NOT EDIT MANUALLY!!! @@ -801,7 +787,7 @@ class Message(TelegramObject): message_thread_id=self.message_thread_id if self.is_topic_message else None, reply_to_message_id=self.message_id, document=document, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -810,14 +796,13 @@ class Message(TelegramObject): protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) def answer_document( self, document: Union[InputFile, str], - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -829,7 +814,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendDocument: """ @@ -844,7 +828,7 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#senddocument :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -854,7 +838,6 @@ class Message(TelegramObject): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_document.SendDocument` """ # DO NOT EDIT MANUALLY!!! @@ -866,7 +849,7 @@ class Message(TelegramObject): chat_id=self.chat.id, message_thread_id=self.message_thread_id if self.is_topic_message else None, document=document, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -876,7 +859,6 @@ class Message(TelegramObject): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -1883,13 +1865,13 @@ class Message(TelegramObject): def reply_sticker( self, sticker: Union[InputFile, str], + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - emoji: Optional[str] = None, **kwargs: Any, ) -> SendSticker: """ @@ -1905,11 +1887,11 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#sendsticker :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param emoji: Emoji associated with the sticker; only for uploaded stickers :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` """ # DO NOT EDIT MANUALLY!!! @@ -1922,17 +1904,18 @@ class Message(TelegramObject): message_thread_id=self.message_thread_id if self.is_topic_message else None, reply_to_message_id=self.message_id, sticker=sticker, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - emoji=emoji, **kwargs, ) def answer_sticker( self, sticker: Union[InputFile, str], + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -1940,7 +1923,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - emoji: Optional[str] = None, **kwargs: Any, ) -> SendSticker: """ @@ -1955,12 +1937,12 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#sendsticker :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param emoji: Emoji associated with the sticker; only for uploaded stickers :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` """ # DO NOT EDIT MANUALLY!!! @@ -1972,12 +1954,12 @@ class Message(TelegramObject): chat_id=self.chat.id, message_thread_id=self.message_thread_id if self.is_topic_message else None, sticker=sticker, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - emoji=emoji, **kwargs, ) @@ -2124,7 +2106,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2136,7 +2118,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendVideo: """ @@ -2155,7 +2136,7 @@ class Message(TelegramObject): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -2165,7 +2146,6 @@ class Message(TelegramObject): :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_video.SendVideo` """ # DO NOT EDIT MANUALLY!!! @@ -2181,7 +2161,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2191,7 +2171,6 @@ class Message(TelegramObject): protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -2201,7 +2180,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2214,7 +2193,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendVideo: """ @@ -2232,7 +2210,7 @@ class Message(TelegramObject): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* @@ -2243,7 +2221,6 @@ class Message(TelegramObject): :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_video.SendVideo` """ # DO NOT EDIT MANUALLY!!! @@ -2258,7 +2235,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2269,7 +2246,6 @@ class Message(TelegramObject): reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -2278,14 +2254,13 @@ class Message(TelegramObject): video_note: Union[InputFile, str], duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendVideoNote: """ @@ -2303,12 +2278,11 @@ class Message(TelegramObject): :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` """ # DO NOT EDIT MANUALLY!!! @@ -2323,12 +2297,11 @@ class Message(TelegramObject): video_note=video_note, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) @@ -2337,7 +2310,7 @@ class Message(TelegramObject): video_note: Union[InputFile, str], duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2345,7 +2318,6 @@ class Message(TelegramObject): reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, - thumbnail: Optional[Union[InputFile, str]] = None, **kwargs: Any, ) -> SendVideoNote: """ @@ -2362,13 +2334,12 @@ class Message(TelegramObject): :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. :param protect_content: Protects the contents of the sent message from forwarding and saving :param reply_to_message_id: If the message is a reply, ID of the original message :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. - :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can only be uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` """ # DO NOT EDIT MANUALLY!!! @@ -2382,13 +2353,12 @@ class Message(TelegramObject): video_note=video_note, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - thumbnail=thumbnail, **kwargs, ) diff --git a/aiogram/types/sticker.py b/aiogram/types/sticker.py index 917605a0..1bac276f 100644 --- a/aiogram/types/sticker.py +++ b/aiogram/types/sticker.py @@ -32,7 +32,7 @@ class Sticker(TelegramObject): """:code:`True`, if the sticker is `animated `_""" is_video: bool """:code:`True`, if the sticker is a `video sticker `_""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Sticker thumbnail in the .WEBP or .JPG format""" emoji: Optional[str] = None """*Optional*. Emoji associated with the sticker""" @@ -44,12 +44,10 @@ class Sticker(TelegramObject): """*Optional*. For mask stickers, the position where the mask should be placed""" custom_emoji_id: Optional[str] = None """*Optional*. For custom emoji stickers, unique identifier of the custom emoji""" - file_size: Optional[int] = None - """*Optional*. File size in bytes""" - thumbnail: Optional[PhotoSize] = None - """*Optional*. Sticker thumbnail in the .WEBP or .JPG format""" needs_repainting: Optional[bool] = None """*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places""" + file_size: Optional[int] = None + """*Optional*. File size in bytes""" def set_position_in_set( self, diff --git a/aiogram/types/sticker_set.py b/aiogram/types/sticker_set.py index 28e1cc12..d212acd0 100644 --- a/aiogram/types/sticker_set.py +++ b/aiogram/types/sticker_set.py @@ -28,7 +28,5 @@ class StickerSet(TelegramObject): """:code:`True`, if the sticker set contains `video stickers `_""" stickers: List[Sticker] """List of all set stickers""" - thumb: Optional[PhotoSize] = None - """*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format""" thumbnail: Optional[PhotoSize] = None """*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format""" diff --git a/aiogram/types/video.py b/aiogram/types/video.py index e82b07fa..ca43493a 100644 --- a/aiogram/types/video.py +++ b/aiogram/types/video.py @@ -25,7 +25,7 @@ class Video(TelegramObject): """Video height as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Video thumbnail""" file_name: Optional[str] = None """*Optional*. Original filename as defined by sender""" @@ -33,5 +33,3 @@ class Video(TelegramObject): """*Optional*. MIME type of the file as defined by sender""" file_size: Optional[int] = None """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" - thumbnail: Optional[PhotoSize] = None - """*Optional*. Video thumbnail""" diff --git a/aiogram/types/video_note.py b/aiogram/types/video_note.py index 393340bb..03654824 100644 --- a/aiogram/types/video_note.py +++ b/aiogram/types/video_note.py @@ -23,9 +23,7 @@ class VideoNote(TelegramObject): """Video width and height (diameter of the video message) as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Video thumbnail""" file_size: Optional[int] = None """*Optional*. File size in bytes""" - thumbnail: Optional[PhotoSize] = None - """*Optional*. Video thumbnail""" diff --git a/docs/api/methods/index.rst b/docs/api/methods/index.rst index 8950ecea..17626855 100644 --- a/docs/api/methods/index.rst +++ b/docs/api/methods/index.rst @@ -29,7 +29,6 @@ Available methods edit_chat_invite_link edit_forum_topic edit_general_forum_topic - edit_message_live_location export_chat_invite_link forward_message get_chat @@ -42,6 +41,8 @@ Available methods get_me get_my_commands get_my_default_administrator_rights + get_my_description + get_my_short_description get_user_profile_photos hide_general_forum_topic leave_chat @@ -76,7 +77,8 @@ Available methods set_chat_title set_my_commands set_my_default_administrator_rights - stop_message_live_location + set_my_description + set_my_short_description unban_chat_member unban_chat_sender_chat unhide_general_forum_topic @@ -104,11 +106,17 @@ Stickers add_sticker_to_set create_new_sticker_set delete_sticker_from_set + delete_sticker_set get_custom_emoji_stickers get_sticker_set send_sticker + set_custom_emoji_sticker_set_thumbnail + set_sticker_emoji_list + set_sticker_keywords + set_sticker_mask_position set_sticker_position_in_set - set_sticker_set_thumb + set_sticker_set_thumbnail + set_sticker_set_title upload_sticker_file Games @@ -121,24 +129,6 @@ Games send_game set_game_score -Upcoming update -=============== - -.. toctree:: - :maxdepth: 1 - - delete_sticker_set - get_my_description - get_my_short_description - set_custom_emoji_sticker_set_thumbnail - set_my_description - set_my_short_description - set_sticker_emoji_list - set_sticker_keywords - set_sticker_mask_position - set_sticker_set_thumbnail - set_sticker_set_title - Getting updates =============== @@ -166,9 +156,11 @@ Updating messages delete_message edit_message_caption + edit_message_live_location edit_message_media edit_message_reply_markup edit_message_text + stop_message_live_location stop_poll Inline mode diff --git a/docs/api/types/index.rst b/docs/api/types/index.rst index 37b7279e..400af0d9 100644 --- a/docs/api/types/index.rst +++ b/docs/api/types/index.rst @@ -59,6 +59,8 @@ Available types bot_command_scope_chat_administrators bot_command_scope_chat_member bot_command_scope_default + bot_description + bot_short_description callback_query chat chat_administrator_rights @@ -170,6 +172,7 @@ Stickers .. toctree:: :maxdepth: 1 + input_sticker mask_position sticker sticker_set @@ -189,16 +192,6 @@ Payments shipping_query successful_payment -Upcoming update -=============== - -.. toctree:: - :maxdepth: 1 - - bot_description - bot_short_description - input_sticker - Games =====