IRequest.Builderpublic static final class GetRecommendationsRequest.Builder extends AbstractDataRequest.Builder<GetRecommendationsRequest.Builder>
GetRecommendationsRequest.| Constructor | Description |
|---|---|
Builder(String accessToken) |
Create a new
GetRecommendationsRequest.Builder instance. |
setBody, setBodyParameter, setContentType, setDefaults, setHeader, setHost, setHttpManager, setPath, setPathParameter, setPort, setQueryParameter, setSchemepublic Builder(String accessToken)
GetRecommendationsRequest.Builder instance.accessToken - Required. A valid access token from the Spotify Accounts service.public GetRecommendationsRequest.Builder limit(Integer limit)
limit - Optional. The target size of the list of recommended tracks. For seeds with unusually small pools or
when highly restrictive filtering is applied, it may be impossible to generate the requested number
of recommended tracks. Debugging information for such cases is available in the response. Default:
20. Minimum: 1. Maximum: 100.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder market(com.neovisionaries.i18n.CountryCode market)
market - Optional. An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track
Relinking. Because min_*, max_* and target_* are applied to pools before
relinking, the generated results may not precisely match the filters applied. Original,
non-relinked tracks are available via the linked_from attribute of the relinked track
response.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_acousticness(Float max_acousticness)
max_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents
high confidence the track is acoustic.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_danceability(Float max_danceability)
max_danceability - Danceability describes how suitable a track is for dancing based on a combination of
musical elements including tempo, rhythm stability, beat strength, and overall
regularity. A value of 0.0 is least danceable and 1.0 is most danceable.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_duration_ms(Integer max_duration_ms)
max_duration_ms - The duration of the track in milliseconds.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_energy(Float max_energy)
max_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and
activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death metal
has high energy, while a Bach prelude scores low on the scale. Perceptual features contributing
to this attribute include dynamic range, perceived loudness, timbre, onset rate, and general
entropy.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_instrumentalness(Float max_instrumentalness)
max_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as
instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal". The
closer the instrumentalness value is to 1.0, the greater likelihood the track
contains no vocal content. Values above 0.5 are intended to represent instrumental
seed_tracks, but confidence is higher as the value approaches 1.0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_key(Integer max_key)
max_key - The key the track is in. Integers map to pitches using standard
Pitch Class notation. E.g. 0 = C, 1 =
C♯/D♭, 2 = D, and so on.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_liveness(Float max_liveness)
max_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an
increased probability that the track was performed live. A value above 0.8 provides strong
likelihood that the track is live.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_loudness(Float max_loudness)
max_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the
entire track and are useful for comparing relative loudness of seed_tracks. Loudness is the
quality of a sound that is the primary psychological correlate of physical strength
(amplitude). Values typical range between -60 and 0 db.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_mode(Integer max_mode)
max_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic
content is derived. Major is represented by 1 and minor is 0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_popularity(Integer max_popularity)
max_popularity - The popularity of the track. The value will be between 0 and 100, with 100 being the most
popular. The popularity is calculated by algorithm and is based, in the most part, on the
total number of plays the track has had and how recent those plays are.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_speechiness(Float max_speechiness)
max_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively
speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the
attribute value. Values above 0.66 describe seed_tracks that are probably made entirely of
spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain both
music and speech, either in sections or layered, including such cases as rap music. Values
below 0.33 most likely represent music and other non-speech-like seed_tracks.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_tempo(Float max_tempo)
max_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology, tempo
is the speed or pace of a given piece and derives directly from the average beat duration.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_time_signature(Integer max_time_signature)
max_time_signature - An estimated overall time signature of a track. The time signature (meter) is a
notational convention to specify how many beats are in each bar (or measure).GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder max_valence(Float max_valence)
max_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks with
high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks with low
valence sound more negative (e.g. sad, depressed, angry).GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_acousticness(Float min_acousticness)
min_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents
high confidence the track is acoustic.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_danceability(Float min_danceability)
min_danceability - Danceability describes how suitable a track is for dancing based on a combination of
musical elements including tempo, rhythm stability, beat strength, and overall
regularity. A value of 0.0 is least danceable and 1.0 is most danceable.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_duration_ms(Integer min_duration_ms)
min_duration_ms - The duration of the track in milliseconds.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_energy(Float min_energy)
min_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and
activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death metal
has high energy, while a Bach prelude scores low on the scale. Perceptual features contributing
to this attribute include dynamic range, perceived loudness, timbre, onset rate, and general
entropy.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_instrumentalness(Float min_instrumentalness)
min_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as
instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal". The
closer the instrumentalness value is to 1.0, the greater likelihood the track
contains no vocal content. Values above 0.5 are intended to represent instrumental
seed_tracks, but confidence is higher as the value approaches 1.0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_key(Integer min_key)
min_key - The key the track is in. Integers map to pitches using standard
Pitch Class notation. E.g. 0 = C, 1 =
C♯/D♭, 2 = D, and so on.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_liveness(Float min_liveness)
min_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an
increased probability that the track was performed live. A value above 0.8 provides strong
likelihood that the track is live.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_loudness(Float min_loudness)
min_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the
entire track and are useful for comparing relative loudness of seed_tracks. Loudness is the
quality of a sound that is the primary psychological correlate of physical strength
(amplitude). Values typical range between -60 and 0 db.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_mode(Integer min_mode)
min_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic
content is derived. Major is represented by 1 and minor is 0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_popularity(Integer min_popularity)
min_popularity - The popularity of the track. The value will be between 0 and 100, with 100 being the most
popular. The popularity is calculated by algorithm and is based, in the most part, on the
total number of plays the track has had and how recent those plays are.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_speechiness(Float min_speechiness)
min_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively
speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the
attribute value. Values above 0.66 describe seed_tracks that are probably made entirely of
spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain both
music and speech, either in sections or layered, including such cases as rap music. Values
below 0.33 most likely represent music and other non-speech-like seed_tracks.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_tempo(Float min_tempo)
min_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology, tempo
is the speed or pace of a given piece and derives directly from the average beat duration.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_time_signature(Integer min_time_signature)
min_time_signature - An estimated overall time signature of a track. The time signature (meter) is a
notational convention to specify how many beats are in each bar (or measure).GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder min_valence(Float min_valence)
min_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks with
high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks with low
valence sound more negative (e.g. sad, depressed, angry).GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder seed_artists(String seed_artists)
seed_artists - A comma separated list of Spotify IDs for seed seed_artists. Up to 5 seed values may be
provided in any combination of seed_artists, seed_tracks and seed_genres.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder seed_genres(String seed_genres)
seed_genres - A comma separated list of any seed_genres in the set of available genre seeds. Up to 5 seed
values may be provided in any combination of seed_artists, seed_tracks and seed_genres.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder seed_tracks(String seed_tracks)
seed_tracks - A comma separated list of Spotify IDs for a seed track. Up to 5 seed values may be provided in
any combination of seed_artists, seed_tracks and seed_genres.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_acousticness(Float target_acousticness)
target_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents
high confidence the track is acoustic.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_danceability(Float target_danceability)
target_danceability - Danceability describes how suitable a track is for dancing based on a combination of
musical elements including tempo, rhythm stability, beat strength, and overall
regularity. A value of 0.0 is least danceable and 1.0 is most danceable.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_duration_ms(Integer target_duration_ms)
target_duration_ms - The duration of the track in milliseconds.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_energy(Float target_energy)
target_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and
activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death
metal has high energy, while a Bach prelude scores low on the scale. Perceptual features
contributing to this attribute include dynamic range, perceived loudness, timbre, onset
rate, and general entropy.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_instrumentalness(Float target_instrumentalness)
target_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as
instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal".
The closer the instrumentalness value is to 1.0, the greater likelihood the track
contains no vocal content. Values above 0.5 are intended to represent instrumental
seed_tracks, but confidence is higher as the value approaches 1.0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_key(Integer target_key)
target_key - The key the track is in. Integers map to pitches using standard
Pitch Class notation. E.g. 0 = C, 1 =
C♯/D♭, 2 = D, and so on.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_liveness(Float target_liveness)
target_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an
increased probability that the track was performed live. A value above 0.8 provides strong
likelihood that the track is live.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_loudness(Float target_loudness)
target_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the
entire track and are useful for comparing relative loudness of seed_tracks. Loudness is
the quality of a sound that is the primary psychological correlate of physical strength
(amplitude). Values typical range between -60 and 0 db.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_mode(Integer target_mode)
target_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its
melodic content is derived. Major is represented by 1 and minor is 0.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_popularity(Integer target_popularity)
target_popularity - The value will be between 0 and 100, with 100 being the most
popular. The popularity is calculated by algorithm and is based, in the most part, on
the total number of plays the track has had and how recent those plays are.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_speechiness(Float target_speechiness)
target_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively
speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the
attribute value. Values above 0.66 describe seed_tracks that are probably made entirely
of spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain
both music and speech, either in sections or layered, including such cases as rap music.
Values below 0.33 most likely represent music and other non-speech-like seed_tracks.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_tempo(Float target_tempo)
target_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology,
tempo is the speed or pace of a given piece and derives directly from the average beat
duration.GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_time_signature(Integer target_time_signature)
target_time_signature - An estimated overall time signature of a track. The time signature (meter) is a
notational convention to specify how many beats are in each bar (or measure).GetRecommendationsRequest.Builder.public GetRecommendationsRequest.Builder target_valence(Float target_valence)
target_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks
with high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks
with low valence sound more negative (e.g. sad, depressed, angry).GetRecommendationsRequest.Builder.public GetRecommendationsRequest build()
GetRecommendationsRequest.Copyright © 2019. All rights reserved.