Bot API 9.4

Author: wiz0u

README.md

@@ -1,7 +1,7 @@
 # .NET Client for Telegram Bot API
 
 [![Nuget](https://img.shields.io/nuget/vpre/Telegram.Bot.svg?label=Telegram.Bot&style=flat-square&color=d8b541)](https://www.nuget.org/packages/Telegram.Bot)
-[![Bot API 9.3](https://img.shields.io/badge/Bot_API-9.3-f36caf.svg?style=flat-square)](https://core.telegram.org/bots/api)
+[![Bot API 9.4](https://img.shields.io/badge/Bot_API-9.4-f36caf.svg?style=flat-square)](https://core.telegram.org/bots/api)
 [![Documentations](https://img.shields.io/badge/Documentations-Book-orange.svg?style=flat-square)](https://telegrambots.github.io/book/)
 [![Telegram Chat](https://img.shields.io/badge/Support_Chat-Telegram-blue.svg?style=flat-square)](https://t.me/joinchat/B35YY0QbLfd034CFnvCtCA)  
 [![Master build](https://img.shields.io/azure-devops/build/tgbots/14f9ab3f-313a-4339-8534-e8b96c7763cc/6?style=flat-square&label=master)](https://dev.azure.com/tgbots/Telegram.Bot/_build/latest?definitionId=6&branchName=master)

src/Telegram.Bot/Requests/Manage Chat/Topics/CreateForumTopicRequest.cs

@@ -1,7 +1,7 @@
 // GENERATED FILE - DO NOT MODIFY MANUALLY
 namespace Telegram.Bot.Requests;
 
-/// <summary>Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the <em>CanManageTopics</em> administrator rights.<para>Returns: Information about the created topic as a <see cref="ForumTopic"/> object.</para></summary>
+/// <summary>Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the <em>CanManageTopics</em> administrator right.<para>Returns: Information about the created topic as a <see cref="ForumTopic"/> object.</para></summary>
 [EditorBrowsable(EditorBrowsableState.Never)]
 public partial class CreateForumTopicRequest() : RequestBase<ForumTopic>("createForumTopic"), IChatTargetable
 {

src/Telegram.Bot/Requests/Other methods/GetUserProfileAudiosRequest.cs

@@ -0,0 +1,18 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Use this method to get a list of profile audios for a user.<para>Returns: A <see cref="UserProfileAudios"/> object.</para></summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class GetUserProfileAudiosRequest() : RequestBase<UserProfileAudios>("getUserProfileAudios"), IUserTargetable
+{
+    /// <summary>Unique identifier of the target user</summary>
+    [JsonPropertyName("user_id")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required long UserId { get; set; }
+
+    /// <summary>Sequential number of the first audio to be returned. By default, all audios are returned.</summary>
+    public int? Offset { get; set; }
+
+    /// <summary>Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.</summary>
+    public int? Limit { get; set; }
+}

src/Telegram.Bot/Requests/Other methods/RemoveMyProfilePhotoRequest.cs

@@ -0,0 +1,7 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Removes the profile photo of the bot.</summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class RemoveMyProfilePhotoRequest() : ParameterlessRequest<bool>("removeMyProfilePhoto")
+{}

src/Telegram.Bot/Requests/Other methods/SetMyProfilePhotoRequest.cs

@@ -0,0 +1,11 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Changes the profile photo of the bot.</summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class SetMyProfilePhotoRequest() : FileRequestBase<bool>("setMyProfilePhoto")
+{
+    /// <summary>The new profile photo to set</summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required InputProfilePhoto Photo { get; set; }
+}

src/Telegram.Bot/Serialization/JsonBotSerializerContext.cs

@@ -36,6 +36,7 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(SendChatActionRequest))]
 [JsonSerializable(typeof(SetMessageReactionRequest))]
 [JsonSerializable(typeof(GetUserProfilePhotosRequest))]
+[JsonSerializable(typeof(GetUserProfileAudiosRequest))]
 [JsonSerializable(typeof(SetUserEmojiStatusRequest))]
 [JsonSerializable(typeof(GetFileRequest))]
 [JsonSerializable(typeof(BanChatMemberRequest))]
@@ -93,6 +94,8 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(GetMyDescriptionRequest))]
 [JsonSerializable(typeof(SetMyShortDescriptionRequest))]
 [JsonSerializable(typeof(GetMyShortDescriptionRequest))]
+[JsonSerializable(typeof(SetMyProfilePhotoRequest))]
+[JsonSerializable(typeof(RemoveMyProfilePhotoRequest))]
 [JsonSerializable(typeof(SetChatMenuButtonRequest))]
 [JsonSerializable(typeof(GetChatMenuButtonRequest))]
 [JsonSerializable(typeof(SetMyDefaultAdministratorRightsRequest))]
@@ -185,6 +188,7 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(ApiResponse<MessageId>))]
 [JsonSerializable(typeof(ApiResponse<Message[]>))]
 [JsonSerializable(typeof(ApiResponse<UserProfilePhotos>))]
+[JsonSerializable(typeof(ApiResponse<UserProfileAudios>))]
 [JsonSerializable(typeof(ApiResponse<TGFile>))]
 [JsonSerializable(typeof(ApiResponse<string>))]
 [JsonSerializable(typeof(ApiResponse<ChatInviteLink>))]

src/Telegram.Bot/TelegramBotClientExtensions.ApiMethods.cs

@@ -1364,6 +1364,26 @@ public static async Task<UserProfilePhotos> GetUserProfilePhotos(
         Limit = limit,
     }, cancellationToken).ConfigureAwait(false);
 
+    /// <summary>Use this method to get a list of profile audios for a user.</summary>
+    /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
+    /// <param name="userId">Unique identifier of the target user</param>
+    /// <param name="offset">Sequential number of the first audio to be returned. By default, all audios are returned.</param>
+    /// <param name="limit">Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.</param>
+    /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation</param>
+    /// <returns>A <see cref="UserProfileAudios"/> object.</returns>
+    public static async Task<UserProfileAudios> GetUserProfileAudios(
+        this ITelegramBotClient botClient,
+        long userId,
+        int? offset = default,
+        int? limit = default,
+        CancellationToken cancellationToken = default
+    ) => await botClient.ThrowIfNull().SendRequest(new GetUserProfileAudiosRequest
+    {
+        UserId = userId,
+        Offset = offset,
+        Limit = limit,
+    }, cancellationToken).ConfigureAwait(false);
+
     /// <summary>Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method <a href="https://core.telegram.org/bots/webapps#initializing-mini-apps">requestEmojiStatusAccess</a>.</summary>
     /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
     /// <param name="userId">Unique identifier of the target user</param>
@@ -1986,7 +2006,7 @@ public static async Task<Sticker[]> GetForumTopicIconStickers(
     {
     }, cancellationToken).ConfigureAwait(false);
 
-    /// <summary>Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the <em>CanManageTopics</em> administrator rights.</summary>
+    /// <summary>Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the <em>CanManageTopics</em> administrator right.</summary>
     /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
     /// <param name="chatId">Unique identifier for the target chat or username of the target supergroup (in the format <c>@supergroupusername</c>)</param>
     /// <param name="name">Topic name, 1-128 characters</param>
@@ -2375,6 +2395,29 @@ public static async Task<BotShortDescription> GetMyShortDescription(
         LanguageCode = languageCode,
     }, cancellationToken).ConfigureAwait(false);
 
+    /// <summary>Changes the profile photo of the bot.</summary>
+    /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
+    /// <param name="photo">The new profile photo to set</param>
+    /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation</param>
+    public static async Task SetMyProfilePhoto(
+        this ITelegramBotClient botClient,
+        InputProfilePhoto photo,
+        CancellationToken cancellationToken = default
+    ) => await botClient.ThrowIfNull().SendRequest(new SetMyProfilePhotoRequest
+    {
+        Photo = photo,
+    }, cancellationToken).ConfigureAwait(false);
+
+    /// <summary>Removes the profile photo of the bot.</summary>
+    /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
+    /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation</param>
+    public static async Task RemoveMyProfilePhoto(
+        this ITelegramBotClient botClient,
+        CancellationToken cancellationToken = default
+    ) => await botClient.ThrowIfNull().SendRequest(new RemoveMyProfilePhotoRequest
+    {
+    }, cancellationToken).ConfigureAwait(false);
+
     /// <summary>Use this method to change the bot's menu button in a private chat, or the default menu button.</summary>
     /// <param name="botClient">An instance of <see cref="ITelegramBotClient"/></param>
     /// <param name="chatId">Unique identifier for the target private chat. If not specified, default bot's menu button will be changed</param>

src/Telegram.Bot/Types/BackgroundType.cs

@@ -93,16 +93,3 @@ public partial class BackgroundTypeChatTheme : BackgroundType
     [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
     public string ThemeName { get; set; } = default!;
 }
-
-/// <summary>This object represents a chat background.</summary>
-public partial class ChatBackground
-{
-    /// <summary>Type of the background</summary>
-    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
-    public BackgroundType Type { get; set; } = default!;
-
-    /// <summary>Implicit conversion to BackgroundType (Type)</summary>
-    public static implicit operator BackgroundType(ChatBackground self) => self.Type;
-    /// <summary>Implicit conversion from BackgroundType (Type)</summary>
-    public static implicit operator ChatBackground(BackgroundType type) => new() { Type = type };
-}

src/Telegram.Bot/Types/Chat.cs

@@ -195,6 +195,10 @@ public partial class ChatFullInfo : Chat
     /// <summary><em>Optional</em>. For private chats, the rating of the user if any</summary>
     public UserRating? Rating { get; set; }
 
+    /// <summary><em>Optional</em>. For private chats, the first audio added to the profile of the user</summary>
+    [JsonPropertyName("first_profile_audio")]
+    public Audio? FirstProfileAudio { get; set; }
+
     /// <summary><em>Optional</em>. The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews</summary>
     [JsonPropertyName("unique_gift_colors")]
     public UniqueGiftColors? UniqueGiftColors { get; set; }

src/Telegram.Bot/Types/ChatBackground.cs

@@ -0,0 +1,15 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Types;
+
+/// <summary>This object represents a chat background.</summary>
+public partial class ChatBackground
+{
+    /// <summary>Type of the background</summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public BackgroundType Type { get; set; } = default!;
+
+    /// <summary>Implicit conversion to BackgroundType (Type)</summary>
+    public static implicit operator BackgroundType(ChatBackground self) => self.Type;
+    /// <summary>Implicit conversion from BackgroundType (Type)</summary>
+    public static implicit operator ChatBackground(BackgroundType type) => new() { Type = type };
+}