Add support for retrieving Zoom Phone call queues

Source/ZoomNet/IZoomClient.cs

@@ -121,6 +121,11 @@ public interface IZoomClient
 		/// </summary>
 		IWebinars Webinars { get; }
 
+		/// <summary>
+		/// Gets the resource which allows you to manage call queues.
+		/// </summary>
+		ICallQueues CallQueues { get; }
+
 		/// <summary>
 		/// Determines if the specified scopes have been granted.
 		/// </summary>

Source/ZoomNet/Json/ZoomNetJsonSerializerContext.cs

@@ -87,6 +87,10 @@ namespace ZoomNet.Json
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogTransferInfoExtensionType))]
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogTransferInfoNumberType))]
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogType))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueue))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueuePhoneNumber))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueueSite))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueueMember))]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotAction), TypeInfoPropertyName = "ChatbotMessageChatbotAction")]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotActions), TypeInfoPropertyName = "ChatbotMessageChatbotActions")]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotActionStyle), TypeInfoPropertyName = "ChatbotMessageChatbotActionStyle")]
@@ -870,6 +874,10 @@ namespace ZoomNet.Json
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogTransferInfoExtensionType[]))]
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogTransferInfoNumberType[]))]
 	[JsonSerializable(typeof(ZoomNet.Models.CallLogType[]))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueue[]))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueuePhoneNumber[]))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueueSite[]))]
+	[JsonSerializable(typeof(ZoomNet.Models.CallQueueMember[]))]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotAction[]), TypeInfoPropertyName = "ChatbotMessageChatbotActionArray")]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotActions[]), TypeInfoPropertyName = "ChatbotMessageChatbotActionsArray")]
 	[JsonSerializable(typeof(ZoomNet.Models.ChatbotMessage.ChatbotActionStyle[]), TypeInfoPropertyName = "ChatbotMessageChatbotActionStyleArray")]

Source/ZoomNet/Models/CallQueue.cs

@@ -0,0 +1,53 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace ZoomNet.Models
+{
+	/// <summary>
+	/// A Call Queue.
+	/// </summary>
+	public class CallQueue
+	{
+		/// <summary>
+		/// Gets or sets the extension id.
+		/// </summary>
+		[JsonPropertyName("extension_id")]
+		public string ExtensionId { get; set; }
+
+		/// <summary>
+		/// Gets or sets the extension number.
+		/// </summary>
+		[JsonPropertyName("extension_number")]
+		public long? ExtensionNumber { get; set; }
+
+		/// <summary>
+		/// Gets or sets the unique identifier of the call queue.
+		/// </summary>
+		[JsonPropertyName("id")]
+		public string Id { get; set; }
+
+		/// <summary>
+		/// Gets or sets the name of the call queue.
+		/// </summary>
+		[JsonPropertyName("name")]
+		public string Name { get; set; }
+
+		/// <summary>
+		/// Gets or sets the phone numbers assigned to the call queue.
+		/// </summary>
+		[JsonPropertyName("phone_numbers")]
+		public List<CallQueuePhoneNumber> PhoneNumbers { get; set; }
+
+		/// <summary>
+		/// Gets or sets the site information.
+		/// </summary>
+		[JsonPropertyName("site")]
+		public CallQueueSite Site { get; set; }
+
+		/// <summary>
+		/// Gets or sets the status of the call queue.
+		/// </summary>
+		[JsonPropertyName("status")]
+		public string Status { get; set; }
+	}
+}

Source/ZoomNet/Models/CallQueueMember.cs

@@ -0,0 +1,40 @@
+using System.Text.Json.Serialization;
+
+namespace ZoomNet.Models
+{
+	/// <summary>
+	/// Represents a member of a call queue, which can be a user or a common area.
+	/// </summary>
+	public class CallQueueMember
+	{
+		/// <summary>
+		/// Gets or sets the member id.
+		/// </summary>
+		[JsonPropertyName("id")]
+		public string Id { get; set; }
+
+		/// <summary>
+		/// Gets or sets the level of the member.
+		/// </summary>
+		[JsonPropertyName("level")]
+		public string Level { get; set; }
+
+		/// <summary>
+		/// Gets or sets the name of the user or common area.
+		/// </summary>
+		[JsonPropertyName("name")]
+		public string Name { get; set; }
+
+		/// <summary>
+		/// Gets or sets a value indicating whether the user can receive calls. It displays if the level is user.
+		/// </summary>
+		[JsonPropertyName("receive_call")]
+		public bool ReceiveCall { get; set; }
+
+		/// <summary>
+		/// Gets or sets the extension ID of the user or common area.
+		/// </summary>
+		[JsonPropertyName("extension_id")]
+		public string ExtensionId { get; set; }
+	}
+}

Source/ZoomNet/Models/CallQueuePhoneNumber.cs

@@ -0,0 +1,33 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace ZoomNet.Models
+{
+	/// <summary>
+	/// Represents a phone number assigned to a call queue.
+	/// </summary>
+	public class CallQueuePhoneNumber
+	{
+		/// <summary>
+		/// Gets or sets the unique identifier of the phone number.
+		/// </summary>
+		[JsonPropertyName("id")]
+		public string Id { get; set; }
+
+		/// <summary>
+		/// Gets or sets the phone number.
+		/// </summary>
+		[JsonPropertyName("number")]
+		public string Number { get; set; }
+
+		/// <summary>
+		/// gets or sets the source of the phone number.
+		/// </summary>
+		[JsonPropertyName("source")]
+		public string Source { get; set; }
+	}
+}

Source/ZoomNet/Models/CallQueueSite.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace ZoomNet.Models
+{
+	/// <summary>
+	/// Represents a site where a Call Queue is assigned.
+	/// </summary>
+	public class CallQueueSite
+	{
+		/// <summary>
+		/// Gets or sets the Unique identifier of the site where the Call Queue is assigned.
+		/// </summary>
+		[JsonPropertyName("id")]
+		public string Id { get; set; }
+
+		/// <summary>
+		/// Gets or sets the name of the site.
+		/// </summary>
+		[JsonPropertyName("name")]
+		public string Name { get; set; }
+	}
+}

Source/ZoomNet/Resources/CallQueues.cs

@@ -0,0 +1,60 @@
+using Pathoschild.Http.Client;
+using System.Threading;
+using System.Threading.Tasks;
+using ZoomNet.Models;
+using ZoomNet.Utilities;
+
+namespace ZoomNet.Resources
+{
+	/// <inheritdoc/>
+	public class CallQueues : ICallQueues
+	{
+		private readonly IClient _client;
+
+		/// <summary>
+		/// Initializes a new instance of the <see cref="CallQueues" /> class.
+		/// </summary>
+		/// <param name="client">The HTTP client.</param>
+		internal CallQueues(IClient client)
+		{
+			_client = client;
+		}
+
+		/// <inheritdoc/>
+		public Task<CallQueue> GetAsync(string callQueueId, CancellationToken cancellationToken = default)
+		{
+			return _client
+				.GetAsync($"phone/call_queues/{callQueueId}")
+				.WithCancellationToken(cancellationToken)
+				.AsObject<CallQueue>();
+		}
+
+		/// <inheritdoc/>
+		public Task<PaginatedResponseWithToken<CallQueue>> GetAllAsync(string department = null, string cost_center = null, string site_id = null, int recordsPerPage = 30, string pagingToken = null, CancellationToken cancellationToken = default)
+		{
+			Utils.ValidateRecordPerPage(recordsPerPage, max: 100);
+
+			return _client
+				.GetAsync($"phone/call_queues")
+				.WithArgument("department", department)
+				.WithArgument("cost_center", cost_center)
+				.WithArgument("site_id", site_id)
+				.WithArgument("page_size", recordsPerPage)
+				.WithArgument("next_page_token", pagingToken)
+				.WithCancellationToken(cancellationToken)
+				.AsPaginatedResponseWithToken<CallQueue>("call_queues");
+		}
+
+		/// <inheritdoc/>
+		public Task<PaginatedResponseWithToken<CallQueueMember>> GetMembersAsync(string callQueueId, int recordsPerPage = 30, string pagingToken = null, CancellationToken cancellationToken = default)
+		{
+			Utils.ValidateRecordPerPage(recordsPerPage);
+			return _client
+				.GetAsync($"phone/call_queues/{callQueueId}/members")
+				.WithArgument("page_size", recordsPerPage)
+				.WithArgument("next_page_token", pagingToken)
+				.WithCancellationToken(cancellationToken)
+				.AsPaginatedResponseWithToken<CallQueueMember>("call_queue_members");
+		}
+	}
+}

Source/ZoomNet/Resources/ICallQueues.cs

@@ -0,0 +1,46 @@
+using System.Threading;
+using System.Threading.Tasks;
+using ZoomNet.Models;
+
+namespace ZoomNet.Resources
+{
+	/// <summary>
+	/// Allows you to manage call queues.
+	/// </summary>
+	public interface ICallQueues
+	{
+		/// <summary>
+		/// Get call queue details.
+		/// </summary>
+		/// <param name="callQueueId">The ID of the call queue.</param>
+		/// <param name="cancellationToken">The cancellation token.</param>
+		/// <returns>
+		/// Details about a <see cref="CallQueue"/>.
+		/// </returns>
+		public Task<CallQueue> GetAsync(string callQueueId, CancellationToken cancellationToken = default);
+
+		/// <summary>
+		/// Get call queues.
+		/// </summary>
+		/// <param name="department">Filter by department.</param>
+		/// <param name="cost_center">Filter by cost center.</param>
+		/// <param name="site_id">Filter by site id.</param>
+		/// <param name="recordsPerPage">The number of records to return.</param>
+		/// <param name="pagingToken">The paging token.</param>
+		/// <param name="cancellationToken">The cancellation token.</param>
+		/// <returns>
+		/// A paginated response of <see cref="CallQueue"/>.
+		/// </returns>
+		public Task<PaginatedResponseWithToken<CallQueue>> GetAllAsync(string department = null, string cost_center = null, string site_id = null, int recordsPerPage = 30, string pagingToken = null, CancellationToken cancellationToken = default);
+
+		/// <summary>
+		/// Get members currently in call queues.
+		/// </summary>
+		/// <param name="callQueueId">The ID of the call queue.</param>
+		/// <param name="recordsPerPage">The number of records to return.</param>
+		/// <param name="pagingToken">The paging token.</param>
+		/// <param name="cancellationToken">The cancellation token.</param>
+		/// <returns>An array of current call queue membership entries.</returns>
+		public Task<PaginatedResponseWithToken<CallQueueMember>> GetMembersAsync(string callQueueId, int recordsPerPage = 30, string pagingToken = null, CancellationToken cancellationToken = default);
+	}
+}

Source/ZoomNet/ZoomClient.cs

@@ -130,6 +130,9 @@ public static string Version
 		/// <inheritdoc/>
 		public IWebinars Webinars { get; private set; }
 
+		/// <inheritdoc/>
+		public ICallQueues CallQueues { get; private set; }
+
 		#endregion
 
 		#region CTOR
@@ -245,6 +248,7 @@ private ZoomClient(IConnectionInfo connectionInfo, HttpClient httpClient, bool d
 			TrackingFields = new TrackingFields(_fluentClient);
 			Users = new Users(_fluentClient);
 			Webinars = new Webinars(_fluentClient);
+			CallQueues = new CallQueues(_fluentClient);
 		}
 
 		/// <summary>