Added gift_premium_subscription

Author: coder2020official

telebot/__init__.py

@@ -6785,6 +6785,42 @@ def delete_story(self, business_connection_id: str, story_id: int) -> bool:
         """
         return apihelper.delete_story(self.token, business_connection_id, story_id)
 
+    def gift_premium_subscription(
+            self, user_id: int, month_count: int, star_count: int,
+            text: Optional[str]=None, text_parse_mode: Optional[str]=None,
+            text_entities: Optional[List[types.MessageEntity]]=None) -> bool:
+        """
+        Gifts a Telegram Premium subscription to the given user. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#giftpremiumsubscription
+
+        :param user_id: Unique identifier of the target user who will receive a Telegram Premium subscription
+        :type user_id: :obj:`int`
+
+        :param month_count: Number of months the Telegram Premium subscription will be active for the user; must be one of 3, 6, or 12
+        :type month_count: :obj:`int`
+
+        :param star_count: Number of Telegram Stars to pay for the Telegram Premium subscription; must be 1000 for 3 months, 1500 for 6 months, and 2500 for 12 months
+        :type star_count: :obj:`int`
+
+        :param text: Text that will be shown along with the service message about the subscription; 0-128 characters
+        :type text: :obj:`str`
+
+        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :type text_parse_mode: :obj:`str`
+
+        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :type text_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.gift_premium_subscription(
+            self.token, user_id, month_count, star_count,
+            text=text, text_parse_mode=text_parse_mode,
+            text_entities=text_entities
+        )
+
     def get_available_gifts(self) -> types.Gifts:
         """
         Returns the list of gifts that can be sent by the bot to users. Requires no parameters. Returns a Gifts object.

telebot/apihelper.py

@@ -2135,6 +2135,18 @@ def delete_story(token, business_connection_id, story_id):
     payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
     return _make_request(token, method_url, params=payload, method='post')
 
+def gift_premium_subscription(token, user_id, month_count, star_count, text=None, text_parse_mode=None,
+                            text_entities=None):
+    method_url = 'giftPremiumSubscription'
+    payload = {'user_id': user_id, 'month_count': month_count, 'star_count': star_count}
+    if text:
+        payload['text'] = text
+    if text_parse_mode:
+        payload['text_parse_mode'] = text_parse_mode
+    if text_entities:
+        payload['text_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(text_entities))
+    return _make_request(token, method_url, params=payload, method='post')
+
 def create_new_sticker_set(
         token, user_id, name, title, stickers, sticker_type=None, needs_repainting=None):
     method_url = 'createNewStickerSet'

telebot/async_telebot.py

@@ -8240,6 +8240,42 @@ async def delete_story(self, business_connection_id: str, story_id: int) -> bool
         :rtype: :obj:`bool`
         """
         return await asyncio_helper.delete_story(self.token, business_connection_id, story_id)
+    
+    async def gift_premium_subscription(
+            self, user_id: int, month_count: int, star_count: int,
+            text: Optional[str]=None, text_parse_mode: Optional[str]=None,
+            text_entities: Optional[List[types.MessageEntity]]=None) -> bool:
+        """
+        Gifts a Telegram Premium subscription to the given user. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#giftpremiumsubscription
+
+        :param user_id: Unique identifier of the target user who will receive a Telegram Premium subscription
+        :type user_id: :obj:`int`
+
+        :param month_count: Number of months the Telegram Premium subscription will be active for the user; must be one of 3, 6, or 12
+        :type month_count: :obj:`int`
+
+        :param star_count: Number of Telegram Stars to pay for the Telegram Premium subscription; must be 1000 for 3 months, 1500 for 6 months, and 2500 for 12 months
+        :type star_count: :obj:`int`
+
+        :param text: Text that will be shown along with the service message about the subscription; 0-128 characters
+        :type text: :obj:`str`
+
+        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :type text_parse_mode: :obj:`str`
+
+        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :type text_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.gift_premium_subscription(
+            self.token, user_id, month_count, star_count,
+            text=text, text_parse_mode=text_parse_mode,
+            text_entities=text_entities
+        )
 
     async def get_available_gifts(self) -> types.Gifts:
         """

telebot/asyncio_helper.py

@@ -2108,6 +2108,19 @@ async def delete_story(token, business_connection_id, story_id):
     payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
     return await _process_request(token, method_url, params=payload, method='post')
 
+async def gift_premium_subscription(token, user_id, month_count, star_count, text=None, text_parse_mode=None,
+                            text_entities=None):
+    method_url = 'giftPremiumSubscription'
+    payload = {'user_id': user_id, 'month_count': month_count, 'star_count': star_count}
+    if text:
+        payload['text'] = text
+    if text_parse_mode:
+        payload['text_parse_mode'] = text_parse_mode
+    if text_entities:
+        payload['text_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(text_entities))
+    return await _process_request(token, method_url, params=payload, method='post')
+
+
 async def get_available_gifts(token):
     method_url = 'getAvailableGifts'
     return await _process_request(token, method_url)