Added the class UserProfileAudios and the method getUserProfileAudios, allowing bots to fetch a list of audios added to the profile of a user.

Author: coder2020official

telebot/__init__.py

@@ -1512,6 +1512,29 @@ def get_user_profile_photos(self, user_id: int, offset: Optional[int]=None,
             apihelper.get_user_profile_photos(self.token, user_id, offset=offset, limit=limit)
         )
 
+    def get_user_profile_audios(self, user_id: int, offset: Optional[int]=None,
+            limit: Optional[int]=None) -> types.UserProfileAudios:
+        """
+        Use this method to get a list of profile audios for a user. Returns a :class:`telebot.types.UserProfileAudios` object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#getuserprofileaudios
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param offset: Sequential number of the first audio to be returned. By default, all audios are returned.
+        :type offset: :obj:`int`
+
+        :param limit: Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+        :type limit: :obj:`int`
+
+        :return: If the request is successful, a UserProfileAudios object is returned.
+        :rtype: :class:`telebot.types.UserProfileAudios`
+        """
+        return types.UserProfileAudios.de_json(
+            apihelper.get_user_profile_audios(self.token, user_id, offset=offset, limit=limit)
+        )
+
     def set_user_emoji_status(self, user_id: int, emoji_status_custom_emoji_id: Optional[str]=None, emoji_status_expiration_date: Optional[int]=None) -> bool:
         """
         Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success.

telebot/apihelper.py

@@ -349,6 +349,16 @@ def get_user_profile_photos(token, user_id, offset=None, limit=None):
     return _make_request(token, method_url, params=payload)
 
 
+def get_user_profile_audios(token, user_id, offset=None, limit=None):
+    method_url = r'getUserProfileAudios'
+    payload = {'user_id': user_id}
+    if offset:
+        payload['offset'] = offset
+    if limit:
+        payload['limit'] = limit
+    return _make_request(token, method_url, params=payload)
+
+
 def set_user_emoji_status(token, user_id, emoji_status_custom_emoji_id=None, emoji_status_expiration_date=None):
     method_url = r'setUserEmojiStatus'
     payload = {'user_id': user_id}

telebot/async_telebot.py

@@ -2989,6 +2989,26 @@ async def get_user_profile_photos(self, user_id: int, offset: Optional[int]=None
         result = await asyncio_helper.get_user_profile_photos(self.token, user_id, offset, limit)
         return types.UserProfilePhotos.de_json(result)
 
+    async def get_user_profile_audios(self, user_id: int, offset: Optional[int]=None, limit: Optional[int]=None) -> types.UserProfileAudios:
+        """
+        Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#getuserprofileaudios
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param offset: Sequential number of the first audio to be returned. By default, all audios are returned.
+        :type offset: :obj:`int`
+
+        :param limit: Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+        :type limit: :obj:`int`
+
+        :return: If successful, returns a UserProfileAudios object.
+        :rtype: :class:`telebot.types.UserProfileAudios`
+        """
+        return types.UserProfileAudios.de_json(await asyncio_helper.get_user_profile_audios(self.token, user_id, offset, limit))
+
     async def set_user_emoji_status(self, user_id: int, emoji_status_custom_emoji_id: Optional[str]=None, emoji_status_expiration_date: Optional[int]=None) -> bool:
         """
         Use this method to change the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess.

telebot/asyncio_helper.py

@@ -330,6 +330,16 @@ async def get_user_profile_photos(token, user_id, offset=None, limit=None):
     return await _process_request(token, method_url, params=payload)
 
 
+async def get_user_profile_audios(token, user_id, offset=None, limit=None):
+    method_url = r'getUserProfileAudios'
+    payload = {'user_id': user_id}
+    if offset:
+        payload['offset'] = offset
+    if limit:
+        payload['limit'] = limit
+    return await _process_request(token, method_url, params=payload)
+
+
 async def set_user_emoji_status(token, user_id, emoji_status_custom_emoji_id=None, emoji_status_expiration_date=None):
     method_url = r'setUserEmojiStatus'
     payload = {'user_id': user_id}

telebot/types.py

@@ -13618,4 +13618,31 @@ def de_json(cls, json_string):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         return cls(**obj)
-    
+    
+
+class UserProfileAudios(JsonDeserializable):
+    """
+    This object represents the audios displayed on a user's profile.
+
+    Telegram documentation: https://core.telegram.org/bots/api#userprofileaudios
+
+    :param total_count: Total number of profile audios for the target user
+    :type total_count: :obj:`int`
+
+    :param audios: Requested profile audios
+    :type audios: :obj:`list` of :class:`Audio`
+
+    :return: Instance of the class
+    :rtype: :class:`UserProfileAudios`
+    """
+    def __init__(self, total_count: int, audios: List[Audio], **kwargs):
+        self.total_count: int = total_count
+        self.audios: List[Audio] = audios
+
+    @classmethod
+    def de_json(cls, json_string):
+        if json_string is None: return None
+        obj = cls.check_json(json_string)
+        obj['audios'] = [Audio.de_json(audio) for audio in obj['audios']]
+        return cls(**obj)
+