com.wrapper.spotify.model_objects.specification

Class Episode

java.lang.Object

com.wrapper.spotify.model_objects.AbstractModelObject

com.wrapper.spotify.model_objects.specification.Episode

All Implemented Interfaces:

IModelObject, IPlaylistItem

public class Episode
extends AbstractModelObject
implements IPlaylistItem

Retrieve information about episode objects by building instances from this class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Episode.Builder Builder class for building Episode instances.
static class	Episode.JsonUtil JsonUtil class for building Episode instances.

Nested classes/interfaces inherited from interface com.wrapper.spotify.model_objects.IModelObject

IModelObject.IJsonUtil<T>

Method Summary

Modifier and Type	Method and Description
Episode.Builder	builder() Create a builder for building an instance of a model object.
String	getAudioPreviewUrl() Get a URL to a 30 second preview (MP3 format) of the episode.
String	getDescription() Get a description of the episode.
Integer	getDurationMs() Get the duration of the episode in milliseconds.
Boolean	getExplicit() Check whether the episode is explicit or not.
Boolean	getExternallyHosted() Check whether the episode is hosted outside of Spotify's CDN.
ExternalUrl	getExternalUrls() Get the external URLs of the episode.
String	getHref() Get the full Spotify Web API endpoint URL of the episode.
String	getId() Get the Spotify ID of the episode.
Image[]	getImages() Get the cover art for the episode in various sizes, widest first.
String[]	getLanguages() Get a list of the languages used in the episode, identified by their ISO 639 code.
String	getName() Get the name of the episode.
Boolean	getPlayable() Check whether the episode is playable in the given market.
String	getReleaseDate() Get the date the episode was first released, for example "1981-12-15".
ReleaseDatePrecision	getReleaseDatePrecision() Get the precision with which the release date is known.
ResumePoint	getResumePoint() Get the user’s most recent position in the episode.
ShowSimplified	getShow() Get the show on which the episode belongs.
ModelObjectType	getType() Get the model object type.
String	getUri() Get the Spotify URI of the episode.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getAudioPreviewUrl

public String getAudioPreviewUrl()

Get a URL to a 30 second preview (MP3 format) of the episode. null if not available.

Returns:

A URL to an audio preview.

getDescription

public String getDescription()

Get a description of the episode.

Returns:

The description of the episode.

getDurationMs

public Integer getDurationMs()

Get the duration of the episode in milliseconds.

Returns:

The length of the episode in milliseconds.

getExplicit

public Boolean getExplicit()

Check whether the episode is explicit or not.

Returns:

Whether or not the episode has explicit content (true = yes it does; false = no it does not OR unknown).

getExternalUrls

public ExternalUrl getExternalUrls()

Get the external URLs of the episode.
Example: Spotify-URL

Returns:

An ExternalUrl object.

getHref

public String getHref()

Get the full Spotify Web API endpoint URL of the episode.

Returns:

A link to the Web API endpoint providing full details of the episode.

getId

public String getId()

Get the Spotify ID of the episode.

Returns:

A Spotify episode ID.

getImages

public Image[] getImages()

Get the cover art for the episode in various sizes, widest first.

Returns:

An array of Image objects.

getExternallyHosted

public Boolean getExternallyHosted()

Check whether the episode is hosted outside of Spotify's CDN.

Returns:

True if the episode is hosted outside of Spotify’s CDN.

getPlayable

public Boolean getPlayable()

Check whether the episode is playable in the given market.

Returns:

True if the episode is playable in the given market. Otherwise false.

getLanguages

public String[] getLanguages()

Get a list of the languages used in the episode, identified by their ISO 639 code.

Returns:

An array of ISO 3166-1 alpha-2 country codes.

getName

public String getName()

Get the name of the episode.

Returns:

The name of the episode.

getReleaseDate

public String getReleaseDate()

Get the date the episode was first released, for example "1981-12-15". Depending on the precision, it might be shown as "1981" or "1981-12".

Returns:

The release date of the episode.

getReleaseDatePrecision

public ReleaseDatePrecision getReleaseDatePrecision()

Get the precision with which the release date is known.

Returns:

A ReleaseDatePrecision object.

getResumePoint

public ResumePoint getResumePoint()

Get the user’s most recent position in the episode. Set if the supplied access token is a user token and has the scope user-read-playback-position.

Returns:

A ResumePoint object.

getShow

public ShowSimplified getShow()

Get the show on which the episode belongs.

Returns:

A Show object on which the episode belongs.

getType

public ModelObjectType getType()

Get the model object type. In this case "episode".

Specified by:

getType in interface IPlaylistItem

Returns:

A ModelObjectType.

getUri

public String getUri()

Get the Spotify URI of the episode.

Returns:

Spotify episode URI.

builder

public Episode.Builder builder()

Description copied from interface: IModelObject

Create a builder for building an instance of a model object.
The type of the builder and its methods depend on its corresponding implementation.

Specified by:

builder in interface IModelObject

Returns:

A builder object.