Thanks to visit codestin.com
Credit goes to github.com

Skip to content

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

Merged
merged 10 commits into from
Apr 23, 2025
Merged

Api 9.0 gifts #4763

merged 10 commits into from
Apr 23, 2025

Conversation

aelkheir
Copy link
Member

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

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.
@aelkheir aelkheir changed the base branch from master to api_9.0 April 19, 2025 19:58
@aelkheir aelkheir mentioned this pull request Apr 19, 2025
35 tasks
@aelkheir aelkheir added the 📋 pending-review work status: pending-review label Apr 19, 2025
Copy link
Member

@Bibo-Joshi Bibo-Joshi left a 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

Comment on lines +428 to +433
* - :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.
Copy link
Member

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 …

@Bibo-Joshi Bibo-Joshi merged commit e6fa43f into api_9.0 Apr 23, 2025
24 of 26 checks passed
@Bibo-Joshi Bibo-Joshi deleted the api_9.0-gifts branch April 23, 2025 15:49
aelkheir added a commit that referenced this pull request Apr 23, 2025
Follow up to #4763. sorry forgot to push before merging.
@Bibo-Joshi Bibo-Joshi removed the 📋 pending-review work status: pending-review label Apr 24, 2025
@github-actions github-actions bot locked and limited conversation to collaborators May 2, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants