Package se.michaelthelin.spotify.requests.data.browse

Class GetListOfFeaturedPlaylistsRequest.Builder

java.lang.Object

se.michaelthelin.spotify.requests.AbstractRequest.Builder<FeaturedPlaylists,GetListOfFeaturedPlaylistsRequest.Builder>

se.michaelthelin.spotify.requests.data.AbstractDataRequest.Builder<FeaturedPlaylists,GetListOfFeaturedPlaylistsRequest.Builder>

se.michaelthelin.spotify.requests.data.browse.GetListOfFeaturedPlaylistsRequest.Builder

All Implemented Interfaces:

IRequest.Builder<FeaturedPlaylists,GetListOfFeaturedPlaylistsRequest.Builder>

Enclosing class:

GetListOfFeaturedPlaylistsRequest

public static final class GetListOfFeaturedPlaylistsRequest.Builder
extends AbstractDataRequest.Builder<FeaturedPlaylists,GetListOfFeaturedPlaylistsRequest.Builder>

Builder class for building a GetListOfFeaturedPlaylistsRequest.

Constructor Summary

Constructors

Constructor	Description
Builder(String accessToken)	Create a new GetListOfFeaturedPlaylistsRequest.Builder instance.

Method Summary

Modifier and Type	Method	Description
GetListOfFeaturedPlaylistsRequest	build()	The request build method.
GetListOfFeaturedPlaylistsRequest.Builder	country(com.neovisionaries.i18n.CountryCode country)	The country code setter.
GetListOfFeaturedPlaylistsRequest.Builder	limit(Integer limit)	The limit setter.
GetListOfFeaturedPlaylistsRequest.Builder	locale(String locale)	The language code setter.
GetListOfFeaturedPlaylistsRequest.Builder	offset(Integer offset)	The offset setter.
protected GetListOfFeaturedPlaylistsRequest.Builder	self()	Return this instance to simulate a self-type.
GetListOfFeaturedPlaylistsRequest.Builder	timestamp(Date timestamp)	The timestamp setter.

Methods inherited from class se.michaelthelin.spotify.requests.AbstractRequest.Builder

setBody, setBodyParameter, setContentType, setDefaults, setHeader, setHost, setHttpManager, setPath, setPathParameter, setPort, setQueryParameter, setScheme

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder(String accessToken)

Create a new GetListOfFeaturedPlaylistsRequest.Builder instance.

Parameters:

accessToken - Required. A valid access token from the Spotify Accounts service.

Method Details

locale

public GetListOfFeaturedPlaylistsRequest.Builder locale(String locale)

The language code setter.

Parameters:

locale - Optional. The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)". Provide this parameter if you want the category metadata returned in a particular language. Note that, if locale is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). The locale parameter, combined with the country parameter, may give odd results if not carefully matched. For example country=SE&locale=de_DE will return a list of categories relevant to Sweden but as German language strings.

Returns:

A GetListOfFeaturedPlaylistsRequest.Builder.

See Also:

• Wikipedia: ISO 3166-1 alpha-2 country codes
• Wikipedia: ISO 639 language code

country

public GetListOfFeaturedPlaylistsRequest.Builder country(com.neovisionaries.i18n.CountryCode country)

The country code setter.

Parameters:

country - Optional. A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country. If omitted, the returned items will be globally relevant.

Returns:

A GetListOfFeaturedPlaylistsRequest.Builder.

See Also:

• Wikipedia: ISO 3166-1 alpha-2 country codes

timestamp

public GetListOfFeaturedPlaylistsRequest.Builder timestamp(Date timestamp)

The timestamp setter.

Parameters:

timestamp - Optional. A timestamp in ISO 8601 format. Use this parameter to specify the user's local time to get results tailored for that specific date and time in the day. If not provided, the response defaults to the current UTC time.

Returns:

A GetListOfFeaturedPlaylistsRequest.Builder.

See Also:

• Wikipedia: ISO 8601 timestamps

limit

public GetListOfFeaturedPlaylistsRequest.Builder limit(Integer limit)

The limit setter.

Parameters:

limit - Optional. The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

Returns:

A GetListOfFeaturedPlaylistsRequest.Builder.

offset

public GetListOfFeaturedPlaylistsRequest.Builder offset(Integer offset)

The offset setter.

Parameters:

offset - Optional. The index of the first item to return. Default: 0 (the first object). Use with limit(Integer) to get the next set of items.

Returns:

A GetListOfFeaturedPlaylistsRequest.Builder.

build

public GetListOfFeaturedPlaylistsRequest build()

The request build method.

Returns:

A custom GetListOfFeaturedPlaylistsRequest.

self

protected GetListOfFeaturedPlaylistsRequest.Builder self()

Description copied from class: AbstractRequest.Builder

Return this instance to simulate a self-type.

Specified by:

self in class AbstractRequest.Builder<FeaturedPlaylists,GetListOfFeaturedPlaylistsRequest.Builder>

Returns:

This instance.