spotted 0.1.0

data/lib/spotted/resources/playlists/tracks.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Playlists
+      class Tracks
+        # Some parameter documentations has been truncated, see
+        # {Spotted::Models::Playlists::TrackUpdateParams} for more details.
+        #
+        # Either reorder or replace items in a playlist depending on the request's
+        # parameters. To reorder items, include `range_start`, `insert_before`,
+        # `range_length` and `snapshot_id` in the request's body. To replace items,
+        # include `uris` as either a query parameter or in the request's body. Replacing
+        # items in a playlist will overwrite its existing items. This operation can be
+        # used for replacing or clearing items in a playlist. <br/> **Note**: Replace and
+        # reorder are mutually exclusive operations which share the same endpoint, but
+        # have different parameters. These operations can't be applied together in a
+        # single request.
+        #
+        # @overload update(playlist_id, body_uris: nil, insert_before: nil, range_length: nil, range_start: nil, snapshot_id: nil, request_options: {})
+        #
+        # @param playlist_id [String] Path param: The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) o
+        #
+        # @param body_uris [Array<String>] Body param:
+        #
+        # @param insert_before [Integer] Body param: The position where the items should be inserted.<br/>To reorder the
+        #
+        # @param range_length [Integer] Body param: The amount of items to be reordered. Defaults to 1 if not set.<br/>T
+        #
+        # @param range_start [Integer] Body param: The position of the first item to be reordered.
+        #
+        # @param snapshot_id [String] Body param: The playlist's snapshot ID against which you want to make the change
+        #
+        # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Spotted::Models::Playlists::TrackUpdateResponse]
+        #
+        # @see Spotted::Models::Playlists::TrackUpdateParams
+        def update(playlist_id, params = {})
+          parsed, options = Spotted::Playlists::TrackUpdateParams.dump_request(params)
+          query_params = [:query_uris]
+          @client.request(
+            method: :put,
+            path: ["playlists/%1$s/tracks", playlist_id],
+            query: parsed.slice(*query_params).transform_keys(query_uris: "uris"),
+            body: parsed.except(*query_params),
+            model: Spotted::Models::Playlists::TrackUpdateResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Spotted::Models::Playlists::TrackListParams} for more details.
+        #
+        # Get full details of the items of a playlist owned by a Spotify user.
+        #
+        # @overload list(playlist_id, additional_types: nil, fields: nil, limit: nil, market: nil, offset: nil, request_options: {})
+        #
+        # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
+        #
+        # @param additional_types [String] A comma-separated list of item types that your client supports besides the defau
+        #
+        # @param fields [String] Filters for the query: a comma-separated list of the
+        #
+        # @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 100.
+        #
+        # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+        #
+        # @param offset [Integer] The index of the first item to return. Default: 0 (the first item). Use with lim
+        #
+        # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Spotted::Internal::CursorURLPage<Spotted::Models::PlaylistTrackObject>]
+        #
+        # @see Spotted::Models::Playlists::TrackListParams
+        def list(playlist_id, params = {})
+          parsed, options = Spotted::Playlists::TrackListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["playlists/%1$s/tracks", playlist_id],
+            query: parsed,
+            page: Spotted::Internal::CursorURLPage,
+            model: Spotted::PlaylistTrackObject,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Spotted::Models::Playlists::TrackAddParams} for more details.
+        #
+        # Add one or more items to a user's playlist.
+        #
+        # @overload add(playlist_id, body_position: nil, body_uris: nil, request_options: {})
+        #
+        # @param playlist_id [String] Path param: The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) o
+        #
+        # @param body_position [Integer] Body param: The position to insert the items, a zero-based index. For example, t
+        #
+        # @param body_uris [Array<String>] Body param: A JSON array of the [Spotify URIs](/documentation/web-api/concepts/s
+        #
+        # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Spotted::Models::Playlists::TrackAddResponse]
+        #
+        # @see Spotted::Models::Playlists::TrackAddParams
+        def add(playlist_id, params = {})
+          parsed, options = Spotted::Playlists::TrackAddParams.dump_request(params)
+          query_params = [:query_position, :query_uris]
+          @client.request(
+            method: :post,
+            path: ["playlists/%1$s/tracks", playlist_id],
+            query: parsed.slice(*query_params).transform_keys(query_position: "position", query_uris: "uris"),
+            body: parsed.except(*query_params),
+            model: Spotted::Models::Playlists::TrackAddResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Spotted::Models::Playlists::TrackRemoveParams} for more details.
+        #
+        # Remove one or more items from a user's playlist.
+        #
+        # @overload remove(playlist_id, tracks:, snapshot_id: nil, request_options: {})
+        #
+        # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
+        #
+        # @param tracks [Array<Spotted::Models::Playlists::TrackRemoveParams::Track>] An array of objects containing [Spotify URIs](/documentation/web-api/concepts/sp
+        #
+        # @param snapshot_id [String] The playlist's snapshot ID against which you want to make the changes.
+        #
+        # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Spotted::Models::Playlists::TrackRemoveResponse]
+        #
+        # @see Spotted::Models::Playlists::TrackRemoveParams
+        def remove(playlist_id, params)
+          parsed, options = Spotted::Playlists::TrackRemoveParams.dump_request(params)
+          @client.request(
+            method: :delete,
+            path: ["playlists/%1$s/tracks", playlist_id],
+            body: parsed,
+            model: Spotted::Models::Playlists::TrackRemoveResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Spotted::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/spotted/resources/playlists.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Playlists
+      # @return [Spotted::Resources::Playlists::Tracks]
+      attr_reader :tracks
+
+      # @return [Spotted::Resources::Playlists::Followers]
+      attr_reader :followers
+
+      # @return [Spotted::Resources::Playlists::Images]
+      attr_reader :images
+
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::PlaylistRetrieveParams} for more details.
+      #
+      # Get a playlist owned by a Spotify user.
+      #
+      # @overload retrieve(playlist_id, additional_types: nil, fields: nil, market: nil, request_options: {})
+      #
+      # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
+      #
+      # @param additional_types [String] A comma-separated list of item types that your client supports besides the defau
+      #
+      # @param fields [String] Filters for the query: a comma-separated list of the
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::PlaylistRetrieveResponse]
+      #
+      # @see Spotted::Models::PlaylistRetrieveParams
+      def retrieve(playlist_id, params = {})
+        parsed, options = Spotted::PlaylistRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["playlists/%1$s", playlist_id],
+          query: parsed,
+          model: Spotted::Models::PlaylistRetrieveResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::PlaylistUpdateParams} for more details.
+      #
+      # Change a playlist's name and public/private state. (The user must, of course,
+      # own the playlist.)
+      #
+      # @overload update(playlist_id, collaborative: nil, description: nil, name: nil, public: nil, request_options: {})
+      #
+      # @param playlist_id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playli
+      #
+      # @param collaborative [Boolean] If `true`, the playlist will become collaborative and other users will be able t
+      #
+      # @param description [String] Value for playlist description as displayed in Spotify Clients and in the Web AP
+      #
+      # @param name [String] The new name for the playlist, for example `"My New Playlist Title"`
+      #
+      # @param public [Boolean] The playlist's public/private status (if it should be added to the user's profil
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Spotted::Models::PlaylistUpdateParams
+      def update(playlist_id, params = {})
+        parsed, options = Spotted::PlaylistUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["playlists/%1$s", playlist_id],
+          body: parsed,
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Client]
+      def initialize(client:)
+        @client = client
+        @tracks = Spotted::Resources::Playlists::Tracks.new(client: client)
+        @followers = Spotted::Resources::Playlists::Followers.new(client: client)
+        @images = Spotted::Resources::Playlists::Images.new(client: client)
+      end
+    end
+  end
+end

data/lib/spotted/resources/recommendations.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Recommendations
+      # @deprecated
+      #
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::RecommendationGetParams} for more details.
+      #
+      # Recommendations are generated based on the available information for a given
+      # seed entity and matched against similar artists and tracks. If there is
+      # sufficient information about the provided seeds, a list of tracks will be
+      # returned together with pool size details.
+      #
+      # For artists and tracks that are very new or obscure there might not be enough
+      # data to generate a list of tracks.
+      #
+      # @overload get(limit: nil, market: nil, max_acousticness: nil, max_danceability: nil, max_duration_ms: nil, max_energy: nil, max_instrumentalness: nil, max_key: nil, max_liveness: nil, max_loudness: nil, max_mode: nil, max_popularity: nil, max_speechiness: nil, max_tempo: nil, max_time_signature: nil, max_valence: nil, min_acousticness: nil, min_danceability: nil, min_duration_ms: nil, min_energy: nil, min_instrumentalness: nil, min_key: nil, min_liveness: nil, min_loudness: nil, min_mode: nil, min_popularity: nil, min_speechiness: nil, min_tempo: nil, min_time_signature: nil, min_valence: nil, seed_artists: nil, seed_genres: nil, seed_tracks: nil, target_acousticness: nil, target_danceability: nil, target_duration_ms: nil, target_energy: nil, target_instrumentalness: nil, target_key: nil, target_liveness: nil, target_loudness: nil, target_mode: nil, target_popularity: nil, target_speechiness: nil, target_tempo: nil, target_time_signature: nil, target_valence: nil, request_options: {})
+      #
+      # @param limit [Integer] The target size of the list of recommended tracks. For seeds with unusually smal
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param max_acousticness [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_danceability [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_duration_ms [Integer] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_energy [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_instrumentalness [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_key [Integer] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_liveness [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_loudness [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_mode [Integer] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_popularity [Integer] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_speechiness [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_tempo [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_time_signature [Integer] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param max_valence [Float] For each tunable track attribute, a hard ceiling on the selected track attribute
+      #
+      # @param min_acousticness [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_danceability [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_duration_ms [Integer] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_energy [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_instrumentalness [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_key [Integer] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_liveness [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_loudness [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_mode [Integer] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_popularity [Integer] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_speechiness [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_tempo [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_time_signature [Integer] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param min_valence [Float] For each tunable track attribute, a hard floor on the selected track attribute’s
+      #
+      # @param seed_artists [String] A comma separated list of [Spotify IDs](/documentation/web-api/concepts/spotify-
+      #
+      # @param seed_genres [String] A comma separated list of any genres in the set of [available genre seeds](/docu
+      #
+      # @param seed_tracks [String] A comma separated list of [Spotify IDs](/documentation/web-api/concepts/spotify-
+      #
+      # @param target_acousticness [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_danceability [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_duration_ms [Integer] Target duration of the track (ms)
+      #
+      # @param target_energy [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_instrumentalness [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_key [Integer] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_liveness [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_loudness [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_mode [Integer] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_popularity [Integer] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_speechiness [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_tempo [Float] Target tempo (BPM)
+      #
+      # @param target_time_signature [Integer] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param target_valence [Float] For each of the tunable track attributes (below) a target value may be provided.
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::RecommendationGetResponse]
+      #
+      # @see Spotted::Models::RecommendationGetParams
+      def get(params = {})
+        parsed, options = Spotted::RecommendationGetParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "recommendations",
+          query: parsed,
+          model: Spotted::Models::RecommendationGetResponse,
+          options: options
+        )
+      end
+
+      # @deprecated
+      #
+      # Retrieve a list of available genres seed parameter values for
+      # [recommendations](/documentation/web-api/reference/get-recommendations).
+      #
+      # @overload list_available_genre_seeds(request_options: {})
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::RecommendationListAvailableGenreSeedsResponse]
+      #
+      # @see Spotted::Models::RecommendationListAvailableGenreSeedsParams
+      def list_available_genre_seeds(params = {})
+        @client.request(
+          method: :get,
+          path: "recommendations/available-genre-seeds",
+          model: Spotted::Models::RecommendationListAvailableGenreSeedsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/spotted/resources/search.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Search
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::SearchRetrieveParams} for more details.
+      #
+      # Get Spotify catalog information about albums, artists, playlists, tracks, shows,
+      # episodes or audiobooks that match a keyword string. Audiobooks are only
+      # available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
+      #
+      # @overload retrieve(q:, type:, include_external: nil, limit: nil, market: nil, offset: nil, request_options: {})
+      #
+      # @param q [String] Your search query.
+      #
+      # @param type [Array<Symbol, Spotted::Models::SearchRetrieveParams::Type>] A comma-separated list of item types to search across. Search results include hi
+      #
+      # @param include_external [Symbol, Spotted::Models::SearchRetrieveParams::IncludeExternal] If `include_external=audio` is specified it signals that the client can play ext
+      #
+      # @param limit [Integer] The maximum number of results to return in each item type.
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param offset [Integer] The index of the first result to return. Use
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::SearchRetrieveResponse]
+      #
+      # @see Spotted::Models::SearchRetrieveParams
+      def retrieve(params)
+        parsed, options = Spotted::SearchRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "search",
+          query: parsed,
+          model: Spotted::Models::SearchRetrieveResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/spotted/resources/shows.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Shows
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::ShowRetrieveParams} for more details.
+      #
+      # Get Spotify catalog information for a single show identified by its unique
+      # Spotify ID.
+      #
+      # @overload retrieve(id, market: nil, request_options: {})
+      #
+      # @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids)
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::ShowRetrieveResponse]
+      #
+      # @see Spotted::Models::ShowRetrieveParams
+      def retrieve(id, params = {})
+        parsed, options = Spotted::ShowRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["shows/%1$s", id],
+          query: parsed,
+          model: Spotted::Models::ShowRetrieveResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::ShowListParams} for more details.
+      #
+      # Get Spotify catalog information for several shows based on their Spotify IDs.
+      #
+      # @overload list(ids:, market: nil, request_options: {})
+      #
+      # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::ShowListResponse]
+      #
+      # @see Spotted::Models::ShowListParams
+      def list(params)
+        parsed, options = Spotted::ShowListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "shows",
+          query: parsed,
+          model: Spotted::Models::ShowListResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::ShowListEpisodesParams} for more details.
+      #
+      # Get Spotify catalog information about an show’s episodes. Optional parameters
+      # can be used to limit the number of episodes returned.
+      #
+      # @overload list_episodes(id, limit: nil, market: nil, offset: nil, request_options: {})
+      #
+      # @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids)
+      #
+      # @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param offset [Integer] The index of the first item to return. Default: 0 (the first item). Use with lim
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Internal::CursorURLPage<Spotted::Models::SimplifiedEpisodeObject>]
+      #
+      # @see Spotted::Models::ShowListEpisodesParams
+      def list_episodes(id, params = {})
+        parsed, options = Spotted::ShowListEpisodesParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["shows/%1$s/episodes", id],
+          query: parsed,
+          page: Spotted::Internal::CursorURLPage,
+          model: Spotted::SimplifiedEpisodeObject,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/spotted/resources/tracks.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Resources
+    class Tracks
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::TrackRetrieveParams} for more details.
+      #
+      # Get Spotify catalog information for a single track identified by its unique
+      # Spotify ID.
+      #
+      # @overload retrieve(id, market: nil, request_options: {})
+      #
+      # @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids)
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::TrackObject]
+      #
+      # @see Spotted::Models::TrackRetrieveParams
+      def retrieve(id, params = {})
+        parsed, options = Spotted::TrackRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["tracks/%1$s", id],
+          query: parsed,
+          model: Spotted::TrackObject,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Spotted::Models::TrackListParams} for more details.
+      #
+      # Get Spotify catalog information for multiple tracks based on their Spotify IDs.
+      #
+      # @overload list(ids:, market: nil, request_options: {})
+      #
+      # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
+      #
+      # @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Spotted::Models::TrackListResponse]
+      #
+      # @see Spotted::Models::TrackListParams
+      def list(params)
+        parsed, options = Spotted::TrackListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "tracks",
+          query: parsed,
+          model: Spotted::Models::TrackListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Spotted::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end