python-telegram-bot · Bibo-Joshi · Apr 23, 2025 · Apr 15, 2025 · Apr 15, 2025 · Apr 16, 2025
diff --git a/changes/unreleased/4756.JT5nmUmGRG6qDEh5ScMn5f.toml b/changes/unreleased/4756.JT5nmUmGRG6qDEh5ScMn5f.toml
@@ -11,3 +11,7 @@ closes_threads = []
 uid = "4759"
 author_uid = "Bibo-Joshi"
 closes_threads = []
+[[pull_requests]]
+uid = "4763"
+author_uid = "aelkheir"
+closes_threads = []
diff --git a/docs/source/inclusions/bot_methods.rst b/docs/source/inclusions/bot_methods.rst
@@ -411,6 +411,8 @@
 
     * - :meth:`~telegram.Bot.get_business_connection`
       - Used for getting information about the business account.
+    * - :meth:`~telegram.Bot.get_business_account_gifts`
+      - Used for getting gifts owned by the business account.
     * - :meth:`~telegram.Bot.read_business_message`
       - Used for marking a message as read.
     * - :meth:`~telegram.Bot.delete_business_messages`
@@ -421,6 +423,14 @@
       - Used for setting the business account username.
     * - :meth:`~telegram.Bot.set_business_account_bio`
       - Used for setting the business account bio.
+    * - :meth:`~telegram.Bot.set_business_account_gift_settings`
+      - Used for setting the business account gift settings.
+    * - :meth:`~telegram.Bot.convert_gift_to_stars`
+      - Used for converting owned reqular gifts to stars.
+    * - :meth:`~telegram.Bot.upgrade_gift`
+      - Used for upgrading owned regular gifts to unique ones.
+    * - :meth:`~telegram.Bot.transfer_gift`
+      - Used for transferring owned unique gifts to another user.
 
 
 .. raw:: html

diff --git a/docs/source/telegram.acceptedgifttypes.rst b/docs/source/telegram.acceptedgifttypes.rst
@@ -0,0 +1,6 @@
+AcceptedGiftTypes
+=================
+
+.. autoclass:: telegram.AcceptedGiftTypes
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.at-tree.rst b/docs/source/telegram.at-tree.rst
@@ -4,6 +4,7 @@ Available Types
 .. toctree::
     :titlesonly:
 
+    telegram.acceptedgifttypes
     telegram.animation
     telegram.audio
     telegram.birthdate
@@ -76,6 +77,7 @@ Available Types
     telegram.forumtopicreopened
     telegram.generalforumtopichidden
     telegram.generalforumtopicunhidden
+    telegram.giftinfo
     telegram.giveaway
     telegram.giveawaycompleted
     telegram.giveawaycreated
@@ -117,6 +119,10 @@ Available Types
     telegram.messageoriginuser
     telegram.messagereactioncountupdated
     telegram.messagereactionupdated
+    telegram.ownedgift
+    telegram.ownedgiftregular
+    telegram.ownedgifts
+    telegram.ownedgiftunique
     telegram.paidmedia
     telegram.paidmediainfo
     telegram.paidmediaphoto
@@ -142,6 +148,12 @@ Available Types
     telegram.switchinlinequerychosenchat
     telegram.telegramobject
     telegram.textquote
+    telegram.uniquegift
+    telegram.uniquegiftbackdrop
+    telegram.uniquegiftbackdropcolors
+    telegram.uniquegiftinfo
+    telegram.uniquegiftmodel
+    telegram.uniquegiftsymbol
     telegram.update
     telegram.user
     telegram.userchatboosts

diff --git a/docs/source/telegram.giftinfo.rst b/docs/source/telegram.giftinfo.rst
@@ -0,0 +1,7 @@
+GiftInfo
+========
+
+.. autoclass:: telegram.GiftInfo
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.ownedgift.rst b/docs/source/telegram.ownedgift.rst
@@ -0,0 +1,6 @@
+OwnedGift
+=========
+
+.. autoclass:: telegram.OwnedGift
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.ownedgiftregular.rst b/docs/source/telegram.ownedgiftregular.rst
@@ -0,0 +1,6 @@
+OwnedGiftRegular
+================
+
+.. autoclass:: telegram.OwnedGiftRegular
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.ownedgifts.rst b/docs/source/telegram.ownedgifts.rst
@@ -0,0 +1,6 @@
+OwnedGifts
+==========
+
+.. autoclass:: telegram.OwnedGifts
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.ownedgiftunique.rst b/docs/source/telegram.ownedgiftunique.rst
@@ -0,0 +1,6 @@
+OwnedGiftUnique
+===============
+
+.. autoclass:: telegram.OwnedGiftUnique
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.uniquegift.rst b/docs/source/telegram.uniquegift.rst
@@ -0,0 +1,7 @@
+UniqueGift
+==========
+
+.. autoclass:: telegram.UniqueGift
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.uniquegiftbackdrop.rst b/docs/source/telegram.uniquegiftbackdrop.rst
@@ -0,0 +1,7 @@
+UniqueGiftBackdrop
+==================
+
+.. autoclass:: telegram.UniqueGiftBackdrop
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.uniquegiftbackdropcolors.rst b/docs/source/telegram.uniquegiftbackdropcolors.rst
@@ -0,0 +1,7 @@
+UniqueGiftBackdropColors
+========================
+
+.. autoclass:: telegram.UniqueGiftBackdropColors
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.uniquegiftinfo.rst b/docs/source/telegram.uniquegiftinfo.rst
@@ -0,0 +1,7 @@
+UniqueGiftInfo
+==============
+
+.. autoclass:: telegram.UniqueGiftInfo
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.uniquegiftmodel.rst b/docs/source/telegram.uniquegiftmodel.rst
@@ -0,0 +1,7 @@
+UniqueGiftModel
+===============
+
+.. autoclass:: telegram.UniqueGiftModel
+    :members:
+    :show-inheritance:
+
diff --git a/docs/source/telegram.uniquegiftsymbol.rst b/docs/source/telegram.uniquegiftsymbol.rst
@@ -0,0 +1,7 @@
+UniqueGiftSymbol
+================
+
+.. autoclass:: telegram.UniqueGiftSymbol
+    :members:
+    :show-inheritance:
+
diff --git a/telegram/__init__.py b/telegram/__init__.py
@@ -20,6 +20,7 @@
 
 __author__ = "devs@python-telegram-bot.org"
 __all__ = (
+    "AcceptedGiftTypes",
     "AffiliateInfo",
     "Animation",
     "Audio",
@@ -104,6 +105,7 @@
     "GeneralForumTopicHidden",
     "GeneralForumTopicUnhidden",
     "Gift",
+    "GiftInfo",
     "Gifts",
     "Giveaway",
     "GiveawayCompleted",
@@ -181,6 +183,10 @@
     "MessageReactionCountUpdated",
     "MessageReactionUpdated",
     "OrderInfo",
+    "OwnedGift",
+    "OwnedGiftRegular",
+    "OwnedGiftUnique",
+    "OwnedGifts",
     "PaidMedia",
     "PaidMediaInfo",
     "PaidMediaPhoto",
@@ -245,6 +251,12 @@
     "TransactionPartnerTelegramAds",
     "TransactionPartnerTelegramApi",
     "TransactionPartnerUser",
+    "UniqueGift",
+    "UniqueGiftBackdrop",
+    "UniqueGiftBackdropColors",
+    "UniqueGiftInfo",
+    "UniqueGiftModel",
+    "UniqueGiftSymbol",
     "Update",
     "User",
     "UserChatBoosts",
@@ -393,7 +405,7 @@
 from ._games.callbackgame import CallbackGame
 from ._games.game import Game
 from ._games.gamehighscore import GameHighScore
-from ._gifts import Gift, Gifts
+from ._gifts import AcceptedGiftTypes, Gift, GiftInfo, Gifts
 from ._giveaway import Giveaway, GiveawayCompleted, GiveawayCreated, GiveawayWinners
 from ._inline.inlinekeyboardbutton import InlineKeyboardButton
 from ._inline.inlinekeyboardmarkup import InlineKeyboardMarkup
@@ -445,6 +457,7 @@
     MessageOriginUser,
 )
 from ._messagereactionupdated import MessageReactionCountUpdated, MessageReactionUpdated
+from ._ownedgift import OwnedGift, OwnedGiftRegular, OwnedGifts, OwnedGiftUnique
 from ._paidmedia import (
     PaidMedia,
     PaidMediaInfo,
@@ -510,6 +523,14 @@
 from ._story import Story
 from ._switchinlinequerychosenchat import SwitchInlineQueryChosenChat
 from ._telegramobject import TelegramObject
+from ._uniquegift import (
+    UniqueGift,
+    UniqueGiftBackdrop,
+    UniqueGiftBackdropColors,
+    UniqueGiftInfo,
+    UniqueGiftModel,
+    UniqueGiftSymbol,
+)
 from ._update import Update
 from ._user import User
 from ._userprofilephotos import UserProfilePhotos