spotted 0.1.0

data/lib/spotted/models/me/player_transfer_params.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Player#transfer
+      class PlayerTransferParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute device_ids
+        #   A JSON array containing the ID of the device on which playback should be
+        #   started/transferred.<br/>For
+        #   example:`{device_ids:["74ASZWbe4lXaubB36ztrGX"]}`<br/>_**Note**: Although an
+        #   array is accepted, only a single device_id is currently supported. Supplying
+        #   more than one will return `400 Bad Request`_
+        #
+        #   @return [Array<String>]
+        required :device_ids, Spotted::Internal::Type::ArrayOf[String]
+
+        # @!attribute play
+        #   **true**: ensure playback happens on new device.<br/>**false** or not provided:
+        #   keep the current playback state.
+        #
+        #   @return [Boolean, nil]
+        optional :play, Spotted::Internal::Type::Boolean
+
+        # @!method initialize(device_ids:, play: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::PlayerTransferParams} for more details.
+        #
+        #   @param device_ids [Array<String>] A JSON array containing the ID of the device on which playback should be started
+        #
+        #   @param play [Boolean] **true**: ensure playback happens on new device.<br/>**false** or not provided:
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/playlist_list_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Playlists#list
+      class PlaylistListParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute limit
+        #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute offset
+        #   '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.'
+        #
+        #   @return [Integer, nil]
+        optional :offset, Integer
+
+        # @!method initialize(limit: nil, offset: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::PlaylistListParams} for more details.
+        #
+        #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @param offset [Integer] 'The index of the first playlist to return. Default:
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/show_check_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Shows#check
+      class ShowCheckParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute ids
+        #   A comma-separated list of the
+        #   [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the shows.
+        #   Maximum: 50 IDs.
+        #
+        #   @return [String]
+        required :ids, String
+
+        # @!method initialize(ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ShowCheckParams} for more details.
+        #
+        #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/show_check_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @type [Spotted::Internal::Type::Converter]
+      ShowCheckResponse = Spotted::Internal::Type::ArrayOf[Spotted::Internal::Type::Boolean]
+    end
+  end
+end

data/lib/spotted/models/me/show_list_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Shows#list
+      class ShowListParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute limit
+        #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute offset
+        #   The index of the first item to return. Default: 0 (the first item). Use with
+        #   limit to get the next set of items.
+        #
+        #   @return [Integer, nil]
+        optional :offset, Integer
+
+        # @!method initialize(limit: nil, offset: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ShowListParams} for more details.
+        #
+        #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @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}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/show_list_response.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Shows#list
+      class ShowListResponse < Spotted::Internal::Type::BaseModel
+        # @!attribute added_at
+        #   The date and time the show was saved. Timestamps are returned in ISO 8601 format
+        #   as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If
+        #   the time is imprecise (for example, the date/time of an album release), an
+        #   additional field indicates the precision; see for example, release_date in an
+        #   album object.
+        #
+        #   @return [Time, nil]
+        optional :added_at, Time
+
+        # @!attribute show
+        #   Information about the show.
+        #
+        #   @return [Spotted::Models::Me::ShowListResponse::Show, nil]
+        optional :show, -> { Spotted::Models::Me::ShowListResponse::Show }
+
+        # @!method initialize(added_at: nil, show: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ShowListResponse} for more details.
+        #
+        #   @param added_at [Time] The date and time the show was saved.
+        #
+        #   @param show [Spotted::Models::Me::ShowListResponse::Show] Information about the show.
+
+        # @see Spotted::Models::Me::ShowListResponse#show
+        class Show < Spotted::Internal::Type::BaseModel
+          # @!attribute id
+          #   The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute available_markets
+          #   A list of the countries in which the show can be played, identified by their
+          #   [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
+          #
+          #   @return [Array<String>]
+          required :available_markets, Spotted::Internal::Type::ArrayOf[String]
+
+          # @!attribute copyrights
+          #   The copyright statements of the show.
+          #
+          #   @return [Array<Spotted::Models::CopyrightObject>]
+          required :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
+
+          # @!attribute description
+          #   A description of the show. HTML tags are stripped away from this field, use
+          #   `html_description` field in case HTML tags are needed.
+          #
+          #   @return [String]
+          required :description, String
+
+          # @!attribute explicit
+          #   Whether or not the show has explicit content (true = yes it does; false = no it
+          #   does not OR unknown).
+          #
+          #   @return [Boolean]
+          required :explicit, Spotted::Internal::Type::Boolean
+
+          # @!attribute external_urls
+          #   External URLs for this show.
+          #
+          #   @return [Spotted::Models::ExternalURLObject]
+          required :external_urls, -> { Spotted::ExternalURLObject }
+
+          # @!attribute href
+          #   A link to the Web API endpoint providing full details of the show.
+          #
+          #   @return [String]
+          required :href, String
+
+          # @!attribute html_description
+          #   A description of the show. This field may contain HTML tags.
+          #
+          #   @return [String]
+          required :html_description, String
+
+          # @!attribute images
+          #   The cover art for the show in various sizes, widest first.
+          #
+          #   @return [Array<Spotted::Models::ImageObject>]
+          required :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
+
+          # @!attribute is_externally_hosted
+          #   True if all of the shows episodes are hosted outside of Spotify's CDN. This
+          #   field might be `null` in some cases.
+          #
+          #   @return [Boolean]
+          required :is_externally_hosted, Spotted::Internal::Type::Boolean
+
+          # @!attribute languages
+          #   A list of the languages used in the show, identified by their
+          #   [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code.
+          #
+          #   @return [Array<String>]
+          required :languages, Spotted::Internal::Type::ArrayOf[String]
+
+          # @!attribute media_type
+          #   The media type of the show.
+          #
+          #   @return [String]
+          required :media_type, String
+
+          # @!attribute name
+          #   The name of the episode.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute publisher
+          #   The publisher of the show.
+          #
+          #   @return [String]
+          required :publisher, String
+
+          # @!attribute total_episodes
+          #   The total number of episodes in the show.
+          #
+          #   @return [Integer]
+          required :total_episodes, Integer
+
+          # @!attribute type
+          #   The object type.
+          #
+          #   @return [Symbol, Spotted::Models::Me::ShowListResponse::Show::Type]
+          required :type, enum: -> { Spotted::Models::Me::ShowListResponse::Show::Type }
+
+          # @!attribute uri
+          #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+          #   show.
+          #
+          #   @return [String]
+          required :uri, String
+
+          # @!method initialize(id:, available_markets:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, is_externally_hosted:, languages:, media_type:, name:, publisher:, total_episodes:, type:, uri:)
+          #   Some parameter documentations has been truncated, see
+          #   {Spotted::Models::Me::ShowListResponse::Show} for more details.
+          #
+          #   Information about the show.
+          #
+          #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
+          #
+          #   @param available_markets [Array<String>] A list of the countries in which the show can be played, identified by their [IS
+          #
+          #   @param copyrights [Array<Spotted::Models::CopyrightObject>] The copyright statements of the show.
+          #
+          #   @param description [String] A description of the show. HTML tags are stripped away from this field, use `htm
+          #
+          #   @param explicit [Boolean] Whether or not the show has explicit content (true = yes it does; false = no it
+          #
+          #   @param external_urls [Spotted::Models::ExternalURLObject] External URLs for this show.
+          #
+          #   @param href [String] A link to the Web API endpoint providing full details of the show.
+          #
+          #   @param html_description [String] A description of the show. This field may contain HTML tags.
+          #
+          #   @param images [Array<Spotted::Models::ImageObject>] The cover art for the show in various sizes, widest first.
+          #
+          #   @param is_externally_hosted [Boolean] True if all of the shows episodes are hosted outside of Spotify's CDN. This fiel
+          #
+          #   @param languages [Array<String>] A list of the languages used in the show, identified by their [ISO 639](https://
+          #
+          #   @param media_type [String] The media type of the show.
+          #
+          #   @param name [String] The name of the episode.
+          #
+          #   @param publisher [String] The publisher of the show.
+          #
+          #   @param total_episodes [Integer] The total number of episodes in the show.
+          #
+          #   @param type [Symbol, Spotted::Models::Me::ShowListResponse::Show::Type] The object type.
+          #
+          #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the show
+
+          # The object type.
+          #
+          # @see Spotted::Models::Me::ShowListResponse::Show#type
+          module Type
+            extend Spotted::Internal::Type::Enum
+
+            SHOW = :show
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spotted/models/me/show_remove_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Shows#remove
+      class ShowRemoveParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute body_ids
+        #   A JSON array of the
+        #   [Spotify IDs](https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids).
+        #   A maximum of 50 items can be specified in one request. _Note: if the `ids`
+        #   parameter is present in the query string, any IDs listed here in the body will
+        #   be ignored._
+        #
+        #   @return [Array<String>, nil]
+        optional :body_ids, Spotted::Internal::Type::ArrayOf[String], api_name: :ids
+
+        # @!attribute market
+        #   An
+        #   [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+        #   If a country code is specified, only content that is available in that market
+        #   will be returned.<br/> If a valid user access token is specified in the request
+        #   header, the country associated with the user account will take priority over
+        #   this parameter.<br/> _**Note**: If neither market or user country are provided,
+        #   the content is considered unavailable for the client._<br/> Users can view the
+        #   country that is associated with their account in the
+        #   [account settings](https://www.spotify.com/account/overview/).
+        #
+        #   @return [String, nil]
+        optional :market, String
+
+        # @!method initialize(body_ids: nil, market: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ShowRemoveParams} for more details.
+        #
+        #   @param body_ids [Array<String>] A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/we
+        #
+        #   @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}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/show_save_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Shows#save
+      class ShowSaveParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute body_ids
+        #   A JSON array of the
+        #   [Spotify IDs](https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids).
+        #   A maximum of 50 items can be specified in one request. _Note: if the `ids`
+        #   parameter is present in the query string, any IDs listed here in the body will
+        #   be ignored._
+        #
+        #   @return [Array<String>, nil]
+        optional :body_ids, Spotted::Internal::Type::ArrayOf[String], api_name: :ids
+
+        # @!method initialize(body_ids: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ShowSaveParams} for more details.
+        #
+        #   @param body_ids [Array<String>] A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/we
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/top_list_top_artists_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Top#list_top_artists
+      class TopListTopArtistsParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute limit
+        #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute offset
+        #   The index of the first item to return. Default: 0 (the first item). Use with
+        #   limit to get the next set of items.
+        #
+        #   @return [Integer, nil]
+        optional :offset, Integer
+
+        # @!attribute time_range
+        #   Over what time frame the affinities are computed. Valid values: `long_term`
+        #   (calculated from ~1 year of data and including all new data as it becomes
+        #   available), `medium_term` (approximately last 6 months), `short_term`
+        #   (approximately last 4 weeks). Default: `medium_term`
+        #
+        #   @return [String, nil]
+        optional :time_range, String
+
+        # @!method initialize(limit: nil, offset: nil, time_range: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::TopListTopArtistsParams} for more details.
+        #
+        #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @param offset [Integer] The index of the first item to return. Default: 0 (the first item). Use with lim
+        #
+        #   @param time_range [String] Over what time frame the affinities are computed. Valid values: `long_term` (cal
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/top_list_top_tracks_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Top#list_top_tracks
+      class TopListTopTracksParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute limit
+        #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute offset
+        #   The index of the first item to return. Default: 0 (the first item). Use with
+        #   limit to get the next set of items.
+        #
+        #   @return [Integer, nil]
+        optional :offset, Integer
+
+        # @!attribute time_range
+        #   Over what time frame the affinities are computed. Valid values: `long_term`
+        #   (calculated from ~1 year of data and including all new data as it becomes
+        #   available), `medium_term` (approximately last 6 months), `short_term`
+        #   (approximately last 4 weeks). Default: `medium_term`
+        #
+        #   @return [String, nil]
+        optional :time_range, String
+
+        # @!method initialize(limit: nil, offset: nil, time_range: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::TopListTopTracksParams} for more details.
+        #
+        #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @param offset [Integer] The index of the first item to return. Default: 0 (the first item). Use with lim
+        #
+        #   @param time_range [String] Over what time frame the affinities are computed. Valid values: `long_term` (cal
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/track_check_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Tracks#check
+      class TrackCheckParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute ids
+        #   A comma-separated list of the
+        #   [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+        #   `ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M`. Maximum: 50 IDs.
+        #
+        #   @return [String]
+        required :ids, String
+
+        # @!method initialize(ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::TrackCheckParams} for more details.
+        #
+        #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/track_check_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @type [Spotted::Internal::Type::Converter]
+      TrackCheckResponse = Spotted::Internal::Type::ArrayOf[Spotted::Internal::Type::Boolean]
+    end
+  end
+end

data/lib/spotted/models/me/track_list_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Tracks#list
+      class TrackListParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        # @!attribute limit
+        #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute market
+        #   An
+        #   [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+        #   If a country code is specified, only content that is available in that market
+        #   will be returned.<br/> If a valid user access token is specified in the request
+        #   header, the country associated with the user account will take priority over
+        #   this parameter.<br/> _**Note**: If neither market or user country are provided,
+        #   the content is considered unavailable for the client._<br/> Users can view the
+        #   country that is associated with their account in the
+        #   [account settings](https://www.spotify.com/account/overview/).
+        #
+        #   @return [String, nil]
+        optional :market, String
+
+        # @!attribute offset
+        #   The index of the first item to return. Default: 0 (the first item). Use with
+        #   limit to get the next set of items.
+        #
+        #   @return [Integer, nil]
+        optional :offset, Integer
+
+        # @!method initialize(limit: nil, market: nil, offset: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::TrackListParams} for more details.
+        #
+        #   @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}]
+      end
+    end
+  end
+end

data/lib/spotted/models/me/track_list_response.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Tracks#list
+      class TrackListResponse < Spotted::Internal::Type::BaseModel
+        # @!attribute added_at
+        #   The date and time the track was saved. Timestamps are returned in ISO 8601
+        #   format as Coordinated Universal Time (UTC) with a zero offset:
+        #   YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an
+        #   album release), an additional field indicates the precision; see for example,
+        #   release_date in an album object.
+        #
+        #   @return [Time, nil]
+        optional :added_at, Time
+
+        # @!attribute track
+        #   Information about the track.
+        #
+        #   @return [Spotted::Models::TrackObject, nil]
+        optional :track, -> { Spotted::TrackObject }
+
+        # @!method initialize(added_at: nil, track: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::TrackListResponse} for more details.
+        #
+        #   @param added_at [Time] The date and time the track was saved.
+        #
+        #   @param track [Spotted::Models::TrackObject] Information about the track.
+      end
+    end
+  end
+end