Add support for method messages.changeConversationMemberRestrictions (#…

…1610) (#1612)

#1610

## Список изменений
- Добавлена поддержка метода
messages.changeConversationMemberRestrictions

##### Обязательно выполните следующие пункты:
- [x] Проверьте что ваш код не содержит конфликтов, и исправьте их по
необходимости
- [x] Напишите тесты, и обязательно проверьте что не падают другие.

##### Внимание! Pull Request'ы с непройденными тестами не принимаются

VkNet.Tests/Categories/Messages/MessagesCategoryTest.cs

@@ -1120,4 +1120,26 @@ public void SetMemberRole()
 			.BeTrue();
 
 	}
+
+	[Fact]
+	public void ChangeConversationMemberRestrictions()
+	{
+		Url = "https://api.vk.com/method/messages.changeConversationMemberRestrictions";
+		ReadCategoryJsonPath(nameof(ChangeConversationMemberRestrictions));
+
+		var response = Api.Messages.ChangeConversationMemberRestrictions(new()
+		{
+			PeerId = 1,
+			MemberIds = new List<long>
+			{
+				814412, 4245645
+			},
+			For = 60,
+			Action = ConversationMemberRestrictionsActionType.Ro
+		});
+
+		response.FailedMemberIds.Should()
+			.BeEquivalentTo(new List<long> { 814412 });
+
+	}
 }

VkNet.Tests/TestData/Categories/Messages/ChangeConversationMemberRestrictions.json

@@ -0,0 +1,7 @@
+{
+	"response": {
+		"failed_member_ids": [
+			814412
+		]
+	}
+}

VkNet/Abstractions/Category/Async/IMessagesCategoryAsync.cs

@@ -1231,6 +1231,20 @@ Task<GetIntentUsersResult> GetIntentUsersAsync(MessagesGetIntentUsersParams getI
 	Task<bool> MarkAsUnreadConversationAsync(long peerId,
 											CancellationToken token = default);
 
+	/// <summary>
+	/// Устанавливает ограничения участнику чата.
+	/// </summary>
+	/// <param name="params">
+	/// Входные параметры запроса
+	/// </param>
+	/// <param name="token">Токен отмены операции</param>
+	/// <returns>
+	/// Возвращает список идентификаторов, к которым не удалось применить ограничения
+	/// </returns>
+	Task<MessagesChangeConversationMemberRestrictionsObject> ChangeConversationMemberRestrictionsAsync(
+		MessagesChangeConversationMemberRestrictionsParams @params,
+		CancellationToken token = default);
+
 	#region Obsoleted
 
 	/// <summary>

VkNet/Abstractions/Category/IMessagesCategory.cs

@@ -170,6 +170,10 @@ GetRecentCallsResult GetRecentCalls(IEnumerable<string> fields, ulong? count = n
 	/// <inheritdoc cref="IMessagesCategoryAsync.SetMemberRoleAsync"/>
 	bool SetMemberRole(string role, long peerId, ulong memberId);
 
+	/// <inheritdoc cref="IMessagesCategoryAsync.ChangeConversationMemberRestrictionsAsync"/>
+	MessagesChangeConversationMemberRestrictionsObject ChangeConversationMemberRestrictions(
+		MessagesChangeConversationMemberRestrictionsParams @params);
+
 	#region Obsoleted
 
 	/// <inheritdoc cref="IMessagesCategoryAsync.DeleteDialogAsync"/>

VkNet/Categories/Async/MessagesCategoryAsync.cs

@@ -412,4 +412,10 @@ public Task<bool> SetMemberRoleAsync(string role,
 										CancellationToken token = default) =>
 		TypeHelper.TryInvokeMethodAsync(() =>
 			SetMemberRole(role, peerId, memberId), token);
+
+	/// <inheritdoc />
+	public Task<MessagesChangeConversationMemberRestrictionsObject> ChangeConversationMemberRestrictionsAsync(
+		MessagesChangeConversationMemberRestrictionsParams @params,
+		CancellationToken token = default) => TypeHelper.TryInvokeMethodAsync(() =>
+		ChangeConversationMemberRestrictions(@params), token);
 }

VkNet/Categories/MessagesCategory.cs

@@ -1470,4 +1470,23 @@ public bool SetMemberRole(string role, long peerId, ulong memberId) => _vk.Call<
 			}
 		});
 
+	/// <inheritdoc />
+	public MessagesChangeConversationMemberRestrictionsObject
+		ChangeConversationMemberRestrictions(MessagesChangeConversationMemberRestrictionsParams @params) =>
+		_vk.Call<MessagesChangeConversationMemberRestrictionsObject>("messages.changeConversationMemberRestrictions",
+			new()
+			{
+				{
+					"peer_id", @params.PeerId
+				},
+				{
+					"member_ids", @params.MemberIds
+				},
+				{
+					"for", @params.For
+				},
+				{
+					"action", @params.Action
+				}
+			});
 }

VkNet/Enums/StringEnums/ConversationMemberRestrictionsActionType.cs

@@ -0,0 +1,22 @@
+using Newtonsoft.Json;
+using VkNet.Utils.JsonConverter;
+
+namespace VkNet.Enums.StringEnums;
+
+/// <summary>
+/// Ограничения участников разговора
+/// </summary>
+[StringEnum]
+[JsonConverter(typeof(TolerantStringEnumConverter))]
+public enum ConversationMemberRestrictionsActionType
+{
+	/// <summary>
+	/// Read/write, пользователь может читать и отправлять сообщения в чат
+	/// </summary>
+	Rw,
+
+	/// <summary>
+	/// Read only, пользователь не может отправлять сообщения в чат
+	/// </summary>
+	Ro
+}

VkNet/Model/MessagesChangeConversationMemberRestrictionsObject.cs

@@ -0,0 +1,18 @@
+using System;
+using System.Collections.ObjectModel;
+using Newtonsoft.Json;
+
+namespace VkNet.Model;
+
+/// <summary>
+/// Результат выполнения запроса установки ограничений участнику чата
+/// </summary>
+[Serializable]
+public class MessagesChangeConversationMemberRestrictionsObject
+{
+	/// <summary>
+	/// Список идентификаторов, к которым не удалось применить ограничения
+	/// </summary>
+	[JsonProperty("failed_member_ids")]
+	public ReadOnlyCollection<long> FailedMemberIds { get; set; }
+}

VkNet/Model/RequestParams/Messages/MessagesChangeConversationMemberRestrictionsParams.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using Newtonsoft.Json;
+using VkNet.Enums.StringEnums;
+
+namespace VkNet.Model;
+
+/// <summary>
+/// Список параметров для метода messages.changeConversationMemberRestrictions
+/// </summary>
+[Serializable]
+public class MessagesChangeConversationMemberRestrictionsParams
+{
+	/// <summary>
+	/// Идентификатор назначения.
+	/// </summary>
+	[JsonProperty("peer_id")]
+	public long PeerId { get; set; }
+
+	/// <summary>
+	/// Идентификаторы пользователей.
+	/// </summary>
+	[JsonProperty("member_ids")]
+	public IEnumerable<long> MemberIds { get; set; }
+
+	/// <summary>
+	/// Время в секундах. Если нужно замутить навсегда, то указывать не нужно.
+	/// </summary>
+	[JsonProperty("for", NullValueHandling = NullValueHandling.Ignore)]
+	public long For { get; set; }
+
+	/// <summary>
+	/// Разрешенные действия.
+	/// </summary>
+	[JsonProperty("action")]
+	public ConversationMemberRestrictionsActionType Action { get; set; }
+}