Class GetFeaturedPlaylistsRequest.Builder

java.lang.Object

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

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

se.michaelthelin.spotify.requests.data.playlists.GetFeaturedPlaylistsRequest.Builder

All Implemented Interfaces:

IRequest.Builder<FeaturedPlaylists, GetFeaturedPlaylistsRequest.Builder>

Enclosing class:

GetFeaturedPlaylistsRequest

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

Builder class for building a GetFeaturedPlaylistsRequest.

Constructor Summary

Constructors

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

Method Summary

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

Methods inherited from class AbstractRequest.Builder

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

Methods inherited from class Object

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

Constructor Details

Builder

public Builder(String accessToken)

Create a new GetFeaturedPlaylistsRequest.Builder instance.

Parameters:

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

Method Details

locale

public GetFeaturedPlaylistsRequest.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 GetFeaturedPlaylistsRequest.Builder.

See Also:

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

country

public GetFeaturedPlaylistsRequest.Builder country(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 GetFeaturedPlaylistsRequest.Builder.

See Also:

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

timestamp

public GetFeaturedPlaylistsRequest.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 GetFeaturedPlaylistsRequest.Builder.

See Also:

• Wikipedia: ISO 8601 timestamps

limit

public GetFeaturedPlaylistsRequest.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 GetFeaturedPlaylistsRequest.Builder.

offset

public GetFeaturedPlaylistsRequest.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 GetFeaturedPlaylistsRequest.Builder.

build

public GetFeaturedPlaylistsRequest build()

The request build method.

Returns:

A custom GetFeaturedPlaylistsRequest.

self

protected GetFeaturedPlaylistsRequest.Builder self()

Description copied from class: AbstractRequest.Builder

Return this instance to simulate a self-type.

Specified by:

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

Returns:

This instance.