From 8017a02a10e7f949fe31222a621e479370bea107 Mon Sep 17 00:00:00 2001
From: "Johnny @PC" <johnny@johnnycrazy.de>
Date: Mon, 7 Dec 2015 14:08:23 +0100
Subject: [PATCH] Added support for /me/album endpoints

---
 SpotifyAPI/Web/SpotifyWebAPI.cs     | 132 ++++++++++++++++++++++++++++
 SpotifyAPI/Web/SpotifyWebBuilder.cs |  50 +++++++++++
 2 files changed, 182 insertions(+)

diff --git a/SpotifyAPI/Web/SpotifyWebAPI.cs b/SpotifyAPI/Web/SpotifyWebAPI.cs
index 77dc8fa4..25e93a71 100644
--- a/SpotifyAPI/Web/SpotifyWebAPI.cs
+++ b/SpotifyAPI/Web/SpotifyWebAPI.cs
@@ -935,6 +935,138 @@ namespace SpotifyAPI.Web
             return new ListResponse<Boolean> { List = null, Error = res["error"].ToObject<Error>() };
         }
 
+        /// <summary>
+        ///     Save one or more albums to the current user’s “Your Music” library.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public ErrorResponse SaveAlbums(List<String> ids)
+        {
+            JArray array = new JArray(ids);
+            return UploadData<ErrorResponse>(_builder.SaveAlbums(), array.ToString(Formatting.None), "PUT") ?? new ErrorResponse();
+        }
+
+        /// <summary>
+        ///     Save one or more albums to the current user’s “Your Music” library asynchronously.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public async Task<ErrorResponse> SaveAlbumsAsync(List<String> ids)
+        {
+            JArray array = new JArray(ids);
+            return await UploadDataAsync<ErrorResponse>(_builder.SaveAlbums(), array.ToString(Formatting.None), "PUT") ?? new ErrorResponse();
+        }
+
+        /// <summary>
+        ///     Save one album to the current user’s “Your Music” library.
+        /// </summary>
+        /// <param name="id">A Spotify ID</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public ErrorResponse SaveAlbum(String id)
+        {
+            return SaveAlbums(new List<string> { id });
+        }
+
+        /// <summary>
+        ///     Save one album to the current user’s “Your Music” library asynchronously.
+        /// </summary>
+        /// <param name="id">A Spotify ID</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public async Task<ErrorResponse> SaveAlbumAsync(String id)
+        {
+            return await SaveAlbumsAsync(new List<string> { id });
+        }
+
+        /// <summary>
+        ///     Get a list of the albums saved in the current Spotify user’s “Your Music” library.
+        /// </summary>
+        /// <param name="limit">The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.</param>
+        /// <param name="offset">The index of the first object to return. Default: 0 (i.e., the first object)</param>
+        /// <param name="market">An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public Paging<SavedTrack> GetSavedAlbums(int limit = 20, int offset = 0, String market = "")
+        {
+            if (!UseAuth)
+                throw new InvalidOperationException("Auth is required for GetSavedAlbums");
+            return DownloadData<Paging<SavedTrack>>(_builder.GetSavedAlbums(limit, offset, market));
+        }
+
+        /// <summary>
+        ///     Get a list of the albums saved in the current Spotify user’s “Your Music” library asynchronously.
+        /// </summary>
+        /// <param name="limit">The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.</param>
+        /// <param name="offset">The index of the first object to return. Default: 0 (i.e., the first object)</param>
+        /// <param name="market">An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public async Task<Paging<SavedTrack>> GetSavedAlbumsAsync(int limit = 20, int offset = 0, String market = "")
+        {
+            if (!UseAuth)
+                throw new InvalidOperationException("Auth is required for GetSavedAlbumsAsync");
+            return await DownloadDataAsync<Paging<SavedTrack>>(_builder.GetSavedAlbums(limit, offset, market));
+        }
+
+        /// <summary>
+        ///     Remove one or more albums from the current user’s “Your Music” library.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public ErrorResponse RemoveSavedAlbums(List<String> ids)
+        {
+            JArray array = new JArray(ids);
+            return UploadData<ErrorResponse>(_builder.RemoveSavedAlbums(), array.ToString(Formatting.None), "DELETE") ?? new ErrorResponse();
+        }
+
+        /// <summary>
+        ///     Remove one or more albums from the current user’s “Your Music” library asynchronously.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public async Task<ErrorResponse> RemoveSavedAlbumsAsync(List<String> ids)
+        {
+            JArray array = new JArray(ids);
+            return await UploadDataAsync<ErrorResponse>(_builder.RemoveSavedAlbums(), array.ToString(Formatting.None), "DELETE") ?? new ErrorResponse();
+        }
+
+        /// <summary>
+        ///     Check if one or more albums is already saved in the current Spotify user’s “Your Music” library.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public ListResponse<Boolean> CheckSavedAlbums(List<String> ids)
+        {
+            if (!UseAuth)
+                throw new InvalidOperationException("Auth is required for CheckSavedTracks");
+            JToken res = DownloadData<JToken>(_builder.CheckSavedAlbums(ids));
+            if (res is JArray)
+                return new ListResponse<Boolean> { List = res.ToObject<List<Boolean>>(), Error = null };
+            return new ListResponse<Boolean> { List = null, Error = res["error"].ToObject<Error>() };
+        }
+
+        /// <summary>
+        ///     Check if one or more albums is already saved in the current Spotify user’s “Your Music” library asynchronously.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public async Task<ListResponse<Boolean>> CheckSavedAlbumsAsync(List<String> ids)
+        {
+            if (!UseAuth)
+                throw new InvalidOperationException("Auth is required for CheckSavedAlbumsAsync");
+            JToken res = await DownloadDataAsync<JToken>(_builder.CheckSavedAlbums(ids));
+            if (res is JArray)
+                return new ListResponse<Boolean> { List = res.ToObject<List<Boolean>>(), Error = null };
+            return new ListResponse<Boolean> { List = null, Error = res["error"].ToObject<Error>() };
+        }
+
         #endregion Library
 
         #region Playlists
diff --git a/SpotifyAPI/Web/SpotifyWebBuilder.cs b/SpotifyAPI/Web/SpotifyWebBuilder.cs
index c03965b5..f978fe2f 100644
--- a/SpotifyAPI/Web/SpotifyWebBuilder.cs
+++ b/SpotifyAPI/Web/SpotifyWebBuilder.cs
@@ -438,6 +438,56 @@ namespace SpotifyAPI.Web
             return APIBase + "/me/tracks/contains?ids=" + string.Join(",", ids);
         }
 
+        /// <summary>
+        ///     Save one or more albums to the current user’s "Your Music" library.
+        /// </summary>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public string SaveAlbums()
+        {
+            return $"{APIBase}/me/albums";
+        }
+
+        /// <summary>
+        ///     Get a list of the albums saved in the current Spotify user’s "Your Music" library.
+        /// </summary>
+        /// <param name="limit">The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.</param>
+        /// <param name="offset">The index of the first object to return. Default: 0 (i.e., the first object)</param>
+        /// <param name="market">An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public string GetSavedAlbums(int limit = 20, int offset = 0, string market = "")
+        {
+            limit = Math.Min(limit, 50);
+            StringBuilder builder = new StringBuilder(APIBase + "/me/albums");
+            builder.Append("?limit=" + limit);
+            builder.Append("&offset=" + offset);
+            if (!string.IsNullOrEmpty(market))
+                builder.Append("&market=" + market);
+            return builder.ToString();
+        }
+
+        /// <summary>
+        ///     Remove one or more albums from the current user’s "Your Music" library.
+        /// </summary>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public string RemoveSavedAlbums()
+        {
+            return APIBase + "/me/albums/";
+        }
+
+        /// <summary>
+        ///     Check if one or more albums is already saved in the current Spotify user’s "Your Music" library.
+        /// </summary>
+        /// <param name="ids">A list of the Spotify IDs.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public string CheckSavedAlbums(List<String> ids)
+        {
+            return APIBase + "/me/tracks/contains?ids=" + string.Join(",", ids);
+        }
+
         #endregion Library
 
         #region Playlists