Add locale param for more endpoints (#1005)

* Add market and locale param for PlayerGetQueue

* Add locale param for UsersTopItemsRequest

Author: WXRIW

SpotifyAPI.Web/Clients/Interfaces/IPlayerClient.cs

@@ -234,5 +234,16 @@ public interface IPlayerClient
     /// </remarks>
     /// <returns></returns>
     Task<QueueResponse> GetQueue(CancellationToken cancel = default);
+
+    /// <summary>
+    /// Get the list of objects that make up the user's queue.
+    /// </summary>
+    /// <param name="request">The request-model which contains required and optional parameters.</param>
+    /// <param name="cancel">The cancellation-token to allow to cancel the request.</param>
+    /// <remarks>
+    /// https://developer.spotify.com/documentation/web-api/reference/#/operations/get-queue
+    /// </remarks>
+    /// <returns></returns>
+    Task<QueueResponse> GetQueue(PlayerGetQueueRequest request, CancellationToken cancel = default);
   }
 }

SpotifyAPI.Web/Clients/PlayerClient.cs

@@ -23,6 +23,13 @@ public Task<QueueResponse> GetQueue(CancellationToken cancel = default)
       return API.Get<QueueResponse>(URLs.PlayerQueue(), cancel);
     }
 
+    public Task<QueueResponse> GetQueue(PlayerGetQueueRequest request, CancellationToken cancel = default)
+    {
+      Ensure.ArgumentNotNull(request, nameof(request));
+
+      return API.Get<QueueResponse>(URLs.PlayerQueue(), request.BuildQueryParams(), cancel);
+    }
+
     public Task<DeviceResponse> GetAvailableDevices(CancellationToken cancel = default)
     {
       return API.Get<DeviceResponse>(URLs.PlayerDevices(), cancel);

SpotifyAPI.Web/Models/Request/PlayerGetQueueRequest.cs

@@ -0,0 +1,24 @@
+namespace SpotifyAPI.Web
+{
+  public class PlayerGetQueueRequest : RequestParams
+  {
+    /// <summary>
+    /// An ISO 3166-1 alpha-2 country code or the string from_token.
+    /// Provide this parameter if you want to apply Track Relinking.
+    /// </summary>
+    /// <value></value>
+    [QueryParam("market")]
+    public string? Market { get; set; }
+
+    /// <summary>
+    /// The desired language, consisting of an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code,
+    /// joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)".
+    /// Provide this parameter if you want the category strings returned in a particular language.
+    /// Note that, if locale is not supplied, or if the specified language is not available,
+    /// the category strings returned will be in the Spotify default language (American English).
+    /// </summary>
+    /// <value></value>
+    [QueryParam("locale")]
+    public string? Locale { get; set; }
+  }
+}

SpotifyAPI.Web/Models/Request/UsersTopItemsRequest.cs

@@ -34,6 +34,17 @@ public UsersTopItemsRequest(TimeRange timeRange)
     [QueryParam("offset")]
     public int? Offset { get; set; }
 
+    /// <summary>
+    /// The desired language, consisting of an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code,
+    /// joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)".
+    /// Provide this parameter if you want the category strings returned in a particular language.
+    /// Note that, if locale is not supplied, or if the specified language is not available,
+    /// the category strings returned will be in the Spotify default language (American English).
+    /// </summary>
+    /// <value></value>
+    [QueryParam("locale")]
+    public string? Locale { get; set; }
+
   }
   public enum TimeRange
   {