-
Notifications
You must be signed in to change notification settings - Fork 5.7k
Api 9.0 gifts #4763
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Api 9.0 gifts #4763
Conversation
Gifts - Added the class `UniqueGift` describing a gift that was upgraded to a unique one. - Added the classes `UniqueGiftModel`, `UniqueGiftSymbol`, `UniqueGiftBackdropColors`, and `UniqueGiftBackdrop` to describe the properties of a unique gift. - Added the class `UniqueGiftInfo` and the field `unique_gift` to the class `Message`, describing a service message about a unique gift that was sent or received. - Added the class `GiftInfo` and the field `gift` to the class `Message`, describing a service message about a regular gift that was sent or received. Also added new filters the new message types; `message.gift` and `message.unique_gift`
Gifts - Added the class `AcceptedGiftTypes` describing the types of gifts that are accepted by a user or a chat.
and tests. Gifts - Replaced the field `can_send_gift` with the field `accepted_gift_types` of the type `AcceptedGiftTypes` in the class `ChatFullInfo`.
plus tests. Business Accounts - Added the classes `OwnedGiftRegular`, `OwnedGiftUnique`, `OwnedGifts` and the method `getBusinessAccountGifts`, allowing bots to fetch the list of gifts owned by a managed business account.
- Added the method `setBusinessAccountGiftSettings`, allowing bots to change the privacy settings pertaining to incoming gifts in a managed business account. - Added the method `convertGiftToStars`, allowing bots to convert gifts received by a managed business account to Telegram Stars. - Added the method `upgradeGift`, allowing bots to upgrade regular gifts received by a managed business account to unique gifts. - Added the method `transferGift`, allowing bots to transfer unique gifts owned by a managed business account.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
wow, you've been busy! Thanks for the PR, really nice :) I've not read every word, but I only left a few smaller comments and it looks like you've found more than I would have though of :D
* - :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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should these go into "payments and stars" above? I guess in the end it doesn't matter much …
Follow up to #4763. sorry forgot to push before merging.
Check-list for PRs
.. versionadded:: NEXT.VERSION
,.. versionchanged:: NEXT.VERSION
,.. deprecated:: NEXT.VERSION
or.. versionremoved:: NEXT.VERSION
to the docstrings for user facing changes (for methods/class descriptions, arguments and attributes)CSI standard <https://standards.mousepawmedia.com/en/stable/csi.html>
____all__
sStability Policy <https://docs.python-telegram-bot.org/stability_policy.html>
_ in case of deprecations or changes to documented behaviorIf the PR contains API changes (otherwise, you can ignore this passage)
Checked the Bot API specific sections of the
Stability Policy <https://docs.python-telegram-bot.org/stability_policy.html>
_Created a PR to remove functionality deprecated in the previous Bot API release (
see here <https://docs.python-telegram-bot.org/en/stable/stability_policy.html#case-2>
_)New classes:
self._id_attrs
and corresponding documentationAdded new shortcuts:
~telegram.Chat
& :class:~telegram.User
for all methods that acceptchat/user_id
If relevant:
telegram.constants
and shortcuts to them as class variables_extbot.py
bot_methods.rst
Business Accounts
Gifts