Add remaining endpoints to interface

Extend existing endpoints with additional params

src/SpotifyApi.NetCore/IPlaylistsApi.cs

@@ -46,16 +46,57 @@ Task<T> GetPlaylists<T>(
 
         #region GetPlaylist
 
-        Task<PlaylistSimplified> GetPlaylist(string playlistId, string accessToken = null);
+        /// <summary>
+        /// Get a playlist owned by a Spotify user.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.
+        /// <param name="fields">Optional. Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. See docs for examples.</param>
+        /// <param name="additionalTypes">Optional. A comma-separated list of item types that your 
+        /// client supports besides the default track type. Valid types are: `track` and `episode`. 
+        /// Note: This parameter was introduced to allow existing clients to maintain their current 
+        /// behaviour and might be deprecated in the future. In addition to providing this parameter, 
+        /// make sure that your client properly handles cases of new types in the future by checking 
+        /// against the type field of each object.</param>
+        /// <param name="market">Optional. An <see cref="SpotifyCountryCodes"/> or the string <see cref="SpotifyCountryCodes._From_Token"/>.
+        /// Provide this parameter if you want to apply Track Relinking.</param>
+        /// <returns>Task of <see cref="PlaylistSimplified"/></returns>
+        Task<PlaylistSimplified> GetPlaylist(
+            string playlistId,
+            string accessToken = null,
+            string fields = null,
+            string[] additionalTypes = null,
+            string market = null);
 
-        Task<T> GetPlaylist<T>(string playlistId, string accessToken = null);
+        /// <summary>
+        /// Get a playlist owned by a Spotify user.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.
+        /// <param name="fields">Optional. Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. See docs for examples.</param>
+        /// <param name="additionalTypes">Optional. A comma-separated list of item types that your 
+        /// client supports besides the default track type. Valid types are: `track` and `episode`. 
+        /// Note: This parameter was introduced to allow existing clients to maintain their current 
+        /// behaviour and might be deprecated in the future. In addition to providing this parameter, 
+        /// make sure that your client properly handles cases of new types in the future by checking 
+        /// against the type field of each object.</param>
+        /// <param name="market">Optional. An <see cref="SpotifyCountryCodes"/> or the string <see cref="SpotifyCountryCodes._From_Token"/>.
+        /// Provide this parameter if you want to apply Track Relinking.</param>
+        /// <typeparam name="T">Optionally provide your own type to deserialise Spotify's response to.</typeparam>
+        /// <returns>Task of T</returns>
+        Task<T> GetPlaylist<T>(
+            string playlistId,
+            string accessToken = null,
+            string fields = null,
+            string[] additionalTypes = null,
+            string market = null);
 
         #endregion
 
         #region GetTracks
 
         /// <summary>
-        /// Get full details of the tracks of a playlist owned by a Spotify user.
+        /// Get full details of the tracks or episodes of a playlist owned by a Spotify user.
         /// </summary>
         /// <param name="playlistId">The Spotify ID for the playlist.</param>
         /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.
@@ -64,6 +105,12 @@ Task<T> GetPlaylists<T>(
         /// <param name="offset">Optional. The index of the first track to return. Default: 0 (the first object).</param>
         /// <param name="market">Optional. An <see cref="SpotifyCountryCodes"/> or the string <see cref="SpotifyCountryCodes._From_Token"/>.
         /// Provide this parameter if you want to apply Track Relinking.</param>
+        /// <param name="additionalTypes">Optional. A comma-separated list of item types that your 
+        /// client supports besides the default track type. Valid types are: `track` and `episode`. 
+        /// Note: This parameter was introduced to allow existing clients to maintain their current 
+        /// behaviour and might be deprecated in the future. In addition to providing this parameter, 
+        /// make sure that your client properly handles cases of new types in the future by checking 
+        /// against the type field of each object.</param>
         /// <returns>Task of <see cref="PlaylistPaged"/></returns>
         /// <remarks>
         /// https://developer.spotify.com/documentation/web-api/reference/playlists/get-playlists-tracks/
@@ -74,7 +121,8 @@ Task<PlaylistPaged> GetTracks(
             string fields = null,
             int? limit = null,
             int offset = 0,
-            string market = null);
+            string market = null,
+            string[] additionalTypes = null);
 
         /// <summary>
         /// Get full details of the tracks of a playlist owned by a Spotify user.
@@ -86,6 +134,12 @@ Task<PlaylistPaged> GetTracks(
         /// <param name="offset">Optional. The index of the first track to return. Default: 0 (the first object).</param>
         /// <param name="market">Optional. An <see cref="SpotifyCountryCodes"/> or the string <see cref="SpotifyCountryCodes._From_Token"/>.
         /// Provide this parameter if you want to apply Track Relinking.</param>
+        /// <param name="additionalTypes">Optional. A comma-separated list of item types that your 
+        /// client supports besides the default track type. Valid types are: `track` and `episode`. 
+        /// Note: This parameter was introduced to allow existing clients to maintain their current 
+        /// behaviour and might be deprecated in the future. In addition to providing this parameter, 
+        /// make sure that your client properly handles cases of new types in the future by checking 
+        /// against the type field of each object.</param>
         /// <typeparam name="T">Optionally provide your own type to deserialise Spotify's response to.</typeparam>
         /// <returns>Task of T</returns>
         /// <remarks>
@@ -97,7 +151,8 @@ Task<T> GetTracks<T>(
             string fields = null,
             int? limit = null,
             int offset = 0,
-            string market = null);
+            string market = null,
+            string[] additionalTypes = null);
 
         #endregion
 
@@ -191,5 +246,150 @@ Task<T> CreatePlaylist<T>(
             PlaylistDetails details,
             string accessToken = null);
         #endregion
+
+        #region GetCurrentUsersPlaylists
+
+        /// <summary>
+        /// Get a list of the playlists owned or followed by the current Spotify user.
+        /// </summary>
+        /// <param name="limit">Optional. The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.</param>
+        /// <param name="offset">Optional. The index of the first playlist to return. Default: 0 (the 
+        /// first object). Maximum offset: 100,000. Use with limit to get the next set of playlists.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <returns>Task of <see cref="PagedPlaylists"/></returns>
+        Task<PagedPlaylists> GetCurrentUsersPlaylists(
+            int? limit = null,
+            int offset = 0,
+            string accessToken = null);
+
+        /// <summary>
+        /// Get a list of the playlists owned or followed by the current Spotify user.
+        /// </summary>
+        /// <param name="limit">Optional. The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.</param>
+        /// <param name="offset">Optional. The index of the first playlist to return. Default: 0 (the 
+        /// first object). Maximum offset: 100,000. Use with limit to get the next set of playlists.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <typeparam name="T">Optional. Type to deserialise response to.</typeparam>
+        /// <returns>Task of T</returns>
+        Task<T> GetCurrentUsersPlaylists<T>(
+            int? limit = null,
+            int offset = 0,
+            string accessToken = null);
+
+        #endregion
+
+        #region GetPlaylistCoverImage
+
+        /// <summary>
+        /// Get the current image associated with a specific playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <returns>Task of <see cref="Image[]"/></returns>
+        Task<Image[]> GetPlaylistCoverImage(
+            string playlistId,
+            string accessToken = null);
+
+        /// <summary>
+        /// Get the current image associated with a specific playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <typeparam name="T">Optional. Type to deserialise response to.</typeparam>
+        /// <returns>Task of T</returns>
+        Task<T> GetPlaylistCoverImage<T>(
+            string playlistId,
+            string accessToken = null);
+
+        #endregion
+
+        #region RemoveItems
+
+        /// <summary>
+        /// Remove one or more items from a user’s playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="spotifyUris">An array of Spotify URIs of the tracks and episodes to remove.</param>
+        /// <param name="snapshotId">Optional. The playlist’s snapshot ID against which you want to 
+        /// make the changes. The API will validate that the specified items exist and in the specified 
+        /// positions and make the changes, even if more recent changes have been made to the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <returns>Task of <see cref="ModifyPlaylistResponse"/></returns>
+        Task<ModifyPlaylistResponse> RemoveItems(
+            string playlistId,
+            string[] spotifyUris,
+            string snapshotId = null,
+            string accessToken = null);
+
+        /// <summary>
+        /// Remove one or more items from a user’s playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="spotifyUriPositions">An array of tuples containing Spotify URIs of the tracks 
+        /// and episodes to remove with their current positions in the playlist of the tracks and 
+        /// episodes to remove.</param>
+        /// <param name="snapshotId">Optional. The playlist’s snapshot ID against which you want to 
+        /// make the changes. The API will validate that the specified items exist and in the specified 
+        /// positions and make the changes, even if more recent changes have been made to the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <returns>Task of <see cref="ModifyPlaylistResponse"/></returns>
+        Task<ModifyPlaylistResponse> RemoveItems(
+            string playlistId,
+            (string uri, int[] positions)[] spotifyUriPositions,
+            string snapshotId = null,
+            string accessToken = null);
+
+        #endregion
+
+        #region ReorderItems
+
+        /// <summary>
+        /// Reorder an item or a group of items in a playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="rangeStart">Required. The position of the first item to be reordered.</param>
+        /// <param name="insertBefore">Required. The position where the items should be inserted.
+        /// To reorder the items to the end of the playlist, simply set <paramref name="insertBefore"/> 
+        /// to the position after the last item. Examples: To reorder the first item to the last position 
+        /// in a playlist with 10 items, set <paramref name="rangeStart"/> to 0, and <paramref name="insertBefore"/> 
+        /// to 10. To reorder the last item in a playlist with 10 items to the start of the playlist, 
+        /// set <paramref name="rangeStart"/> to 9, and <paramref name="insertBefore"/> to 0.</param>
+        /// <param name="rangeLength">Optional. The amount of items to be reordered. Defaults to 1 if 
+        /// not set. The range of items to be reordered begins from the <paramref name="rangeStart"/> 
+        /// position, and includes the <paramref name="rangeLength"/> subsequent items. Example: To move the items at 
+        /// index 9-10 to the start of the playlist, <paramref name="rangeStart"/> is set to 9, and 
+        /// <paramref name="rangeLength"/> is set to 2.</param>
+        /// <param name="snapshotId">Optional. The playlist’s snapshot ID against which you want to 
+        /// make the changes. The API will validate that the specified items exist and in the specified 
+        /// positions and make the changes, even if more recent changes have been made to the playlist.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        /// <returns>Task of <see cref="ModifyPlaylistResponse"/></returns>
+        Task<ModifyPlaylistResponse> ReorderItems(
+            string playlistId,
+            int rangeStart,
+            int insertBefore,
+            int rangeLength = 1,
+            string snapshotId = null,
+            string accessToken = null);
+
+        #endregion
+
+        #region ReplaceItems
+
+        /// <summary>
+        /// Replace all the items in a playlist, overwriting its existing items. This powerful request 
+        /// can be useful for replacing items, re-ordering existing items, or clearing the playlist.
+        /// </summary>
+        /// <param name="playlistId">The Spotify ID for the playlist.</param>
+        /// <param name="spotifyUris">Optional. A comma-separated list of Spotify URIs to set, can 
+        /// be track or episode URIs. A maximum of 100 items can be set in one request.</param>
+        /// <param name="accessToken">Optional. A valid access token from the Spotify Accounts service.</param>
+        Task ReplaceItems(
+            string playlistId,
+            string[] spotifyUris,
+            string accessToken = null);
+
+        #endregion
+
     }
 }