BOT API v9.0

[mircoianese]

Hello,

This draft PR introduces support for the latest BOT API version (v9.0).

There are quite a few changes, so I'm working on implementing them incrementally.
I'm doing this in Kotlin, which I’m not very experienced with...any suggestions / corrections / explanations are very welcome (thanks!).

Business Accounts

• Added the class BusinessBotRights and replaced the field can_reply with the field rights of the type BusinessBotRights in the class BusinessConnection.
• Added the method readBusinessMessage, allowing bots to mark incoming messages as read on behalf of a business account.
• Added the method deleteBusinessMessages, allowing bots to delete messages on behalf of a business account.
• Added the method setBusinessAccountName, allowing bots to change the first and last name of a managed business account.
• Added the method setBusinessAccountUsername, allowing bots to change the username of a managed business account.
• Added the method setBusinessAccountBio, allowing bots to change the bio of a managed business account.
• Added the class InputProfilePhoto, describing a profile photo to be set.
• Added the methods setBusinessAccountProfilePhoto and removeBusinessAccountProfilePhoto, allowing bots to change the profile photo of 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 class StarAmount and the method getBusinessAccountStarBalance, allowing bots to check the current Telegram Star balance of a managed business account.
• Added the method transferBusinessAccountStars, allowing bots to transfer Telegram Stars from the balance of a managed business account to their own balance for withdrawal.
• 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.
• Added the classes InputStoryContentPhoto and InputStoryContentVideo representing the content of a story to post.
• Added the classes StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather and StoryAreaTypeUniqueGift, describing clickable active areas on stories.
• Added the method postStory, allowing bots to post a story on behalf of a managed business account.
• Added the method editStory, allowing bots to edit stories they had previously posted on behalf of a managed business account.
• Added the method deleteStory, allowing bots to delete stories they had previously posted on behalf of a managed business account.

Mini Apps

• Added the field DeviceStorage, allowing Mini Apps to use persistent local storage on the user's device.
• Added the field SecureStorage, allowing Mini Apps to use a secure local storage on the user's device for sensitive data.

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.

Telegram Premium

• Added the method giftPremiumSubscription, allowing bots to gift a user a Telegram Premium subscription paid in Telegram Stars.
• Added the field premium_subscription_duration to the class TransactionPartnerUser for transactions involving a Telegram Premium subscription purchased by the bot.
• Added the field transaction_type to the class TransactionPartnerUser, simplifying the differentiation and processing of all transaction types.

General

• Increased the maximum price for paid media to 10000 Telegram Stars.
• Increased the maximum price for a subscription period to 10000 Telegram Stars.
• Added the class PaidMessagePriceChanged and the field paid_message_price_changed to the class Message, describing a service message about a price change for paid messages sent to the chat.
• Added the field paid_star_count to the class Message, containing the number of Telegram Stars that were paid to send the message.

[Copilot]

Pull Request Overview

This PR upgrades the Java/Kotlin client to Telegram BOT API v9.0 by adding new business-account endpoints, gift/star models, story components, and mini-app storage fields, along with updating core message/chat classes, bumping the library version, and refreshing docs.

• Introduce new data models and methods for business accounts, gifts (regular & unique), stars, and stories
• Extend Message and ChatFullInfo to handle gift-related service messages and accepted gift types
• Bump version to 9.0.0 and update README for both English and Russian docs

Reviewed Changes

Copilot reviewed 62 out of 62 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
UniqueGiftModel.kt	Add model for unique gift metadata
UniqueGiftInfo.kt	Add service info wrapper for a unique gift
UniqueGiftBackdropColors.kt	Add unique gift backdrop color palette
UniqueGiftBackdrop.kt	Add unique gift backdrop model
UniqueGift.kt	Add top-level unique gift model
OwnedGifts.kt	Add container for a user’s owned gifts
OwnedGiftUnique.kt	Add class for a unique owned gift
OwnedGiftRegular.kt	Add builder-style class for a regular owned gift
OwnedGift.kt	Add base class for owned gifts
GiftInfo.kt	Add service info wrapper for a regular gift
AcceptedGiftTypes.kt	Add model describing which gift types a chat accepts
BusinessConnection.java	Replace deprecated can_reply with new rights field
BusinessBotRights.kt	Add rights model for business bots
PaidMessagePriceChanged.kt	Add model for paid message price-change service messages
Message.java	Extend with gift, unique_gift, paid_message_price_changed, paid_star_count
LocationAddress.kt	Add builder for address components in story areas
ChatFullInfo.java	Replace deprecated can_send_gift with acceptedGiftTypes
gradle.properties	Bump library version to 9.0.0
README_RU.md	Update Russian README to v9.0
README.md	Update English README to v9.0

Comments suppressed due to low confidence (1)

library/src/main/java/com/pengrad/telegrambot/model/gift/owned/OwnedGiftRegular.kt:7

• There are no unit tests covering the builder methods and JSON serialization of OwnedGiftRegular. Consider adding tests to validate that each apply-style setter and the overall serialization/deserialization behave as expected.

class OwnedGiftRegular private constructor(