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

Class GetListOfCategoriesRequest.Builder

java.lang.Object

se.michaelthelin.spotify.requests.AbstractRequest.Builder<Paging<Category>,GetListOfCategoriesRequest.Builder>

se.michaelthelin.spotify.requests.data.AbstractDataRequest.Builder<Paging<Category>,GetListOfCategoriesRequest.Builder>

se.michaelthelin.spotify.requests.data.AbstractDataPagingRequest.Builder<Category,GetListOfCategoriesRequest.Builder>

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

All Implemented Interfaces:

IPagingRequestBuilder<Category,GetListOfCategoriesRequest.Builder>, IRequest.Builder<Paging<Category>,GetListOfCategoriesRequest.Builder>

Enclosing class:

GetListOfCategoriesRequest

public static final class GetListOfCategoriesRequest.Builder
extends AbstractDataPagingRequest.Builder<Category,GetListOfCategoriesRequest.Builder>

Builder class for building a GetListOfCategoriesRequest.

Constructor Summary

Constructors

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

Method Summary

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

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

Methods inherited from interface se.michaelthelin.spotify.requests.IRequest.Builder

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

Constructor Details

Builder

public Builder(String accessToken)

Create a new GetListOfCategoriesRequest.Builder instance.

Parameters:

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

Method Details

country

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

See Also:

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

locale

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

See Also:

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

limit

public GetListOfCategoriesRequest.Builder limit(Integer limit)

The limit setter.

Parameters:

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

Returns:

A GetListOfCategoriesRequest.Builder.

offset

public GetListOfCategoriesRequest.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 categories.

Returns:

A GetListOfCategoriesRequest.Builder.

build

public GetListOfCategoriesRequest build()

The request build method.

Returns:

A custom GetListOfCategoriesRequest.

self

protected GetListOfCategoriesRequest.Builder self()

Description copied from class: AbstractRequest.Builder

Return this instance to simulate a self-type.

Specified by:

self in class AbstractRequest.Builder<Paging<Category>,GetListOfCategoriesRequest.Builder>

Returns:

This instance.