Api 9.0 gifts

[aelkheir]

Check-list for PRs

• Added .. 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)
• Created new or adapted existing unit tests
• Documented code changes according to the CSI standard <https://standards.mousepawmedia.com/en/stable/csi.html>__
• Added new classes & modules to the docs and all suitable __all__ s
• Checked the Stability Policy <https://docs.python-telegram-bot.org/stability_policy.html>_ in case of deprecations or changes to documented behavior

If 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:

  • Added self._id_attrs and corresponding documentation

• Added new shortcuts:

  • In :class:~telegram.Chat & :class:~telegram.User for all methods that accept chat/user_id

• If relevant:

  • Added new constants at :mod:telegram.constants and shortcuts to them as class variables
  • Link new and existing constants in docstrings instead of hard-coded numbers and strings
  • Added new filters for new message (sub)types
  • Added the new method(s) to _extbot.py
  • Added or updated bot_methods.rst

Business Accounts

• Added the method setBusinessAccountGiftSettings, allowing bots to change the privacy settings pertaining to incoming gifts in a managed business account.
• 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 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.

Gifts

• Added the classes UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors, and UniqueGiftBackdrop to describe the properties of a unique gift.
• Added the class UniqueGift describing a gift that was upgraded to a unique one.
• Added the class AcceptedGiftTypes describing the types of gifts that are accepted by a user or a chat.
• Replaced the field can_send_gift with the field accepted_gift_types of the type AcceptedGiftTypes in the class ChatFullInfo.
• 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.
• 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.

[Bibo-Joshi]

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

[Bibo-Joshi]

should these go into "payments and stars" above? I guess in the end it doesn't matter much …