spotted 0.1.0

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

@@ -0,0 +1,287 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Audiobooks#list
+      class AudiobookListResponse < Spotted::Internal::Type::BaseModel
+        # @!attribute added_at
+        #   The date and time the audiobook 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 audiobook
+        #   Information about the audiobook.
+        #
+        #   @return [Spotted::Models::Me::AudiobookListResponse::Audiobook, nil]
+        optional :audiobook, -> { Spotted::Models::Me::AudiobookListResponse::Audiobook }
+
+        # @!method initialize(added_at: nil, audiobook: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::AudiobookListResponse} for more details.
+        #
+        #   @param added_at [Time] The date and time the audiobook was saved
+        #
+        #   @param audiobook [Spotted::Models::Me::AudiobookListResponse::Audiobook] Information about the audiobook.
+
+        # @see Spotted::Models::Me::AudiobookListResponse#audiobook
+        class Audiobook < Spotted::Internal::Type::BaseModel
+          # @!attribute id
+          #   The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+          #   audiobook.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute authors
+          #   The author(s) for the audiobook.
+          #
+          #   @return [Array<Spotted::Models::AuthorObject>]
+          required :authors, -> { Spotted::Internal::Type::ArrayOf[Spotted::AuthorObject] }
+
+          # @!attribute available_markets
+          #   A list of the countries in which the audiobook 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 chapters
+          #   The chapters of the audiobook.
+          #
+          #   @return [Spotted::Models::Me::AudiobookListResponse::Audiobook::Chapters]
+          required :chapters, -> { Spotted::Models::Me::AudiobookListResponse::Audiobook::Chapters }
+
+          # @!attribute copyrights
+          #   The copyright statements of the audiobook.
+          #
+          #   @return [Array<Spotted::Models::CopyrightObject>]
+          required :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
+
+          # @!attribute description
+          #   A description of the audiobook. 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 audiobook 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 audiobook.
+          #
+          #   @return [Spotted::Models::ExternalURLObject]
+          required :external_urls, -> { Spotted::ExternalURLObject }
+
+          # @!attribute href
+          #   A link to the Web API endpoint providing full details of the audiobook.
+          #
+          #   @return [String]
+          required :href, String
+
+          # @!attribute html_description
+          #   A description of the audiobook. This field may contain HTML tags.
+          #
+          #   @return [String]
+          required :html_description, String
+
+          # @!attribute images
+          #   The cover art for the audiobook in various sizes, widest first.
+          #
+          #   @return [Array<Spotted::Models::ImageObject>]
+          required :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
+
+          # @!attribute languages
+          #   A list of the languages used in the audiobook, 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 audiobook.
+          #
+          #   @return [String]
+          required :media_type, String
+
+          # @!attribute name
+          #   The name of the audiobook.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute narrators
+          #   The narrator(s) for the audiobook.
+          #
+          #   @return [Array<Spotted::Models::NarratorObject>]
+          required :narrators, -> { Spotted::Internal::Type::ArrayOf[Spotted::NarratorObject] }
+
+          # @!attribute publisher
+          #   The publisher of the audiobook.
+          #
+          #   @return [String]
+          required :publisher, String
+
+          # @!attribute total_chapters
+          #   The number of chapters in this audiobook.
+          #
+          #   @return [Integer]
+          required :total_chapters, Integer
+
+          # @!attribute type
+          #   The object type.
+          #
+          #   @return [Symbol, Spotted::Models::Me::AudiobookListResponse::Audiobook::Type]
+          required :type, enum: -> { Spotted::Models::Me::AudiobookListResponse::Audiobook::Type }
+
+          # @!attribute uri
+          #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+          #   audiobook.
+          #
+          #   @return [String]
+          required :uri, String
+
+          # @!attribute edition
+          #   The edition of the audiobook.
+          #
+          #   @return [String, nil]
+          optional :edition, String
+
+          # @!method initialize(id:, authors:, available_markets:, chapters:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, languages:, media_type:, name:, narrators:, publisher:, total_chapters:, type:, uri:, edition: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Spotted::Models::Me::AudiobookListResponse::Audiobook} for more details.
+          #
+          #   Information about the audiobook.
+          #
+          #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the audio
+          #
+          #   @param authors [Array<Spotted::Models::AuthorObject>] The author(s) for the audiobook.
+          #
+          #   @param available_markets [Array<String>] A list of the countries in which the audiobook can be played, identified by thei
+          #
+          #   @param chapters [Spotted::Models::Me::AudiobookListResponse::Audiobook::Chapters] The chapters of the audiobook.
+          #
+          #   @param copyrights [Array<Spotted::Models::CopyrightObject>] The copyright statements of the audiobook.
+          #
+          #   @param description [String] A description of the audiobook. HTML tags are stripped away from this field, use
+          #
+          #   @param explicit [Boolean] Whether or not the audiobook has explicit content (true = yes it does; false = n
+          #
+          #   @param external_urls [Spotted::Models::ExternalURLObject] External URLs for this audiobook.
+          #
+          #   @param href [String] A link to the Web API endpoint providing full details of the audiobook.
+          #
+          #   @param html_description [String] A description of the audiobook. This field may contain HTML tags.
+          #
+          #   @param images [Array<Spotted::Models::ImageObject>] The cover art for the audiobook in various sizes, widest first.
+          #
+          #   @param languages [Array<String>] A list of the languages used in the audiobook, identified by their [ISO 639](htt
+          #
+          #   @param media_type [String] The media type of the audiobook.
+          #
+          #   @param name [String] The name of the audiobook.
+          #
+          #   @param narrators [Array<Spotted::Models::NarratorObject>] The narrator(s) for the audiobook.
+          #
+          #   @param publisher [String] The publisher of the audiobook.
+          #
+          #   @param total_chapters [Integer] The number of chapters in this audiobook.
+          #
+          #   @param type [Symbol, Spotted::Models::Me::AudiobookListResponse::Audiobook::Type] The object type.
+          #
+          #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the audi
+          #
+          #   @param edition [String] The edition of the audiobook.
+
+          # @see Spotted::Models::Me::AudiobookListResponse::Audiobook#chapters
+          class Chapters < Spotted::Internal::Type::BaseModel
+            # @!attribute href
+            #   A link to the Web API endpoint returning the full result of the request
+            #
+            #   @return [String]
+            required :href, String
+
+            # @!attribute items
+            #
+            #   @return [Array<Spotted::Models::SimplifiedChapterObject>]
+            required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedChapterObject] }
+
+            # @!attribute limit
+            #   The maximum number of items in the response (as set in the query or by default).
+            #
+            #   @return [Integer]
+            required :limit, Integer
+
+            # @!attribute next_
+            #   URL to the next page of items. ( `null` if none)
+            #
+            #   @return [String, nil]
+            required :next_, String, api_name: :next, nil?: true
+
+            # @!attribute offset
+            #   The offset of the items returned (as set in the query or by default)
+            #
+            #   @return [Integer]
+            required :offset, Integer
+
+            # @!attribute previous
+            #   URL to the previous page of items. ( `null` if none)
+            #
+            #   @return [String, nil]
+            required :previous, String, nil?: true
+
+            # @!attribute total
+            #   The total number of items available to return.
+            #
+            #   @return [Integer]
+            required :total, Integer
+
+            # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+            #   Some parameter documentations has been truncated, see
+            #   {Spotted::Models::Me::AudiobookListResponse::Audiobook::Chapters} for more
+            #   details.
+            #
+            #   The chapters of the audiobook.
+            #
+            #   @param href [String] A link to the Web API endpoint returning the full result of the request
+            #
+            #   @param items [Array<Spotted::Models::SimplifiedChapterObject>]
+            #
+            #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
+            #
+            #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
+            #
+            #   @param offset [Integer] The offset of the items returned (as set in the query or by default)
+            #
+            #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
+            #
+            #   @param total [Integer] The total number of items available to return.
+          end
+
+          # The object type.
+          #
+          # @see Spotted::Models::Me::AudiobookListResponse::Audiobook#type
+          module Type
+            extend Spotted::Internal::Type::Enum
+
+            AUDIOBOOK = :audiobook
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Audiobooks#remove
+      class AudiobookRemoveParams < 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=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. Maximum: 50 IDs.
+        #
+        #   @return [String]
+        required :ids, String
+
+        # @!method initialize(ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::AudiobookRemoveParams} 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/audiobook_save_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Audiobooks#save
+      class AudiobookSaveParams < 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=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. Maximum: 50 IDs.
+        #
+        #   @return [String]
+        required :ids, String
+
+        # @!method initialize(ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::AudiobookSaveParams} 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/context_object.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      class ContextObject < Spotted::Internal::Type::BaseModel
+        # @!attribute external_urls
+        #   External URLs for this context.
+        #
+        #   @return [Spotted::Models::ExternalURLObject, nil]
+        optional :external_urls, -> { Spotted::ExternalURLObject }
+
+        # @!attribute href
+        #   A link to the Web API endpoint providing full details of the track.
+        #
+        #   @return [String, nil]
+        optional :href, String
+
+        # @!attribute type
+        #   The object type, e.g. "artist", "playlist", "album", "show".
+        #
+        #   @return [String, nil]
+        optional :type, String
+
+        # @!attribute uri
+        #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+        #   context.
+        #
+        #   @return [String, nil]
+        optional :uri, String
+
+        # @!method initialize(external_urls: nil, href: nil, type: nil, uri: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::ContextObject} for more details.
+        #
+        #   @param external_urls [Spotted::Models::ExternalURLObject] External URLs for this context.
+        #
+        #   @param href [String] A link to the Web API endpoint providing full details of the track.
+        #
+        #   @param type [String] The object type, e.g. "artist", "playlist", "album", "show".
+        #
+        #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the cont
+      end
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      class DeviceObject < Spotted::Internal::Type::BaseModel
+        # @!attribute id
+        #   The device ID. This ID is unique and persistent to some extent. However, this is
+        #   not guaranteed and any cached `device_id` should periodically be cleared out and
+        #   refetched as necessary.
+        #
+        #   @return [String, nil]
+        optional :id, String, nil?: true
+
+        # @!attribute is_active
+        #   If this device is the currently active device.
+        #
+        #   @return [Boolean, nil]
+        optional :is_active, Spotted::Internal::Type::Boolean
+
+        # @!attribute is_private_session
+        #   If this device is currently in a private session.
+        #
+        #   @return [Boolean, nil]
+        optional :is_private_session, Spotted::Internal::Type::Boolean
+
+        # @!attribute is_restricted
+        #   Whether controlling this device is restricted. At present if this is "true" then
+        #   no Web API commands will be accepted by this device.
+        #
+        #   @return [Boolean, nil]
+        optional :is_restricted, Spotted::Internal::Type::Boolean
+
+        # @!attribute name
+        #   A human-readable name for the device. Some devices have a name that the user can
+        #   configure (e.g. \"Loudest speaker\") and some devices have a generic name
+        #   associated with the manufacturer or device model.
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute supports_volume
+        #   If this device can be used to set the volume.
+        #
+        #   @return [Boolean, nil]
+        optional :supports_volume, Spotted::Internal::Type::Boolean
+
+        # @!attribute type
+        #   Device type, such as "computer", "smartphone" or "speaker".
+        #
+        #   @return [String, nil]
+        optional :type, String
+
+        # @!attribute volume_percent
+        #   The current volume in percent.
+        #
+        #   @return [Integer, nil]
+        optional :volume_percent, Integer, nil?: true
+
+        # @!method initialize(id: nil, is_active: nil, is_private_session: nil, is_restricted: nil, name: nil, supports_volume: nil, type: nil, volume_percent: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::DeviceObject} for more details.
+        #
+        #   @param id [String, nil] The device ID. This ID is unique and persistent to some extent. However, this is
+        #
+        #   @param is_active [Boolean] If this device is the currently active device.
+        #
+        #   @param is_private_session [Boolean] If this device is currently in a private session.
+        #
+        #   @param is_restricted [Boolean] Whether controlling this device is restricted. At present if this is "true" then
+        #
+        #   @param name [String] A human-readable name for the device. Some devices have a name that the user can
+        #
+        #   @param supports_volume [Boolean] If this device can be used to set the volume.
+        #
+        #   @param type [String] Device type, such as "computer", "smartphone" or "speaker".
+        #
+        #   @param volume_percent [Integer, nil] The current volume in percent.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Episodes#check
+      class EpisodeCheckParams < 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
+        #   episodes. Maximum: 50 IDs.
+        #
+        #   @return [String]
+        required :ids, String
+
+        # @!method initialize(ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::EpisodeCheckParams} 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/episode_check_response.rb

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

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Episodes#list
+      class EpisodeListParams < 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::EpisodeListParams} 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/episode_list_response.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Episodes#list
+      class EpisodeListResponse < Spotted::Internal::Type::BaseModel
+        # @!attribute added_at
+        #   The date and time the episode was saved. Timestamps are returned in ISO 8601
+        #   format as Coordinated Universal Time (UTC) with a zero offset:
+        #   YYYY-MM-DDTHH:MM:SSZ.
+        #
+        #   @return [Time, nil]
+        optional :added_at, Time
+
+        # @!attribute episode
+        #   Information about the episode.
+        #
+        #   @return [Spotted::Models::EpisodeObject, nil]
+        optional :episode, -> { Spotted::EpisodeObject }
+
+        # @!method initialize(added_at: nil, episode: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::EpisodeListResponse} for more details.
+        #
+        #   @param added_at [Time] The date and time the episode was saved.
+        #
+        #   @param episode [Spotted::Models::EpisodeObject] Information about the episode.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Episodes#remove
+      class EpisodeRemoveParams < 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](/documentation/web-api/concepts/spotify-uris-ids). <br/>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::EpisodeRemoveParams} for more details.
+        #
+        #   @param body_ids [Array<String>] A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-i
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    module Me
+      # @see Spotted::Resources::Me::Episodes#save
+      class EpisodeSaveParams < 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](/documentation/web-api/concepts/spotify-uris-ids). <br/>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>]
+        required :body_ids, Spotted::Internal::Type::ArrayOf[String], api_name: :ids
+
+        # @!method initialize(body_ids:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::Me::EpisodeSaveParams} for more details.
+        #
+        #   @param body_ids [Array<String>] A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-i
+        #
+        #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end