Class RemovePlaylistItemsRequest.Builder

java.lang.Object

se.michaelthelin.spotify.requests.AbstractRequest.Builder<SnapshotResult, RemovePlaylistItemsRequest.Builder>

se.michaelthelin.spotify.requests.data.AbstractDataRequest.Builder<SnapshotResult, RemovePlaylistItemsRequest.Builder>

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

All Implemented Interfaces:

IRequest.Builder<SnapshotResult, RemovePlaylistItemsRequest.Builder>

Enclosing class:

RemovePlaylistItemsRequest

public static final class RemovePlaylistItemsRequest.Builder
extends AbstractDataRequest.Builder<SnapshotResult, RemovePlaylistItemsRequest.Builder>

Builder class for building a RemovePlaylistItemsRequest.

Constructor Summary

Constructors

Constructor	Description
Builder(String accessToken)	Create a new RemovePlaylistItemsRequest.Builder.

Method Summary

Modifier and Type	Method	Description
RemovePlaylistItemsRequest	build()	The request build method.
RemovePlaylistItemsRequest.Builder	playlist_id(String playlist_id)	The playlist ID setter.
protected RemovePlaylistItemsRequest.Builder	self()	Return this instance to simulate a self-type.
RemovePlaylistItemsRequest.Builder	snapshotId(String snapshotId)	The playlist snapshot ID setter.
RemovePlaylistItemsRequest.Builder	tracks(com.google.gson.JsonArray tracks)	The item URIs 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 RemovePlaylistItemsRequest.Builder.

Removing items from an user's public playlists requires authorization of the playlist-modify-public scope; removing items from an user's private playlist (including collaborative playlists) requires the playlist-modify-private scope.

Parameters:

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

See Also:

• Spotify: Using Scopes

Method Details

playlist_id

public RemovePlaylistItemsRequest.Builder playlist_id(String playlist_id)

The playlist ID setter.

Parameters:

playlist_id - The Spotify ID for the playlist.

Returns:

An RemovePlaylistItemsRequest.Builder.

See Also:

• Spotify: URIs & IDs

tracks

public RemovePlaylistItemsRequest.Builder tracks(com.google.gson.JsonArray tracks)

The item URIs setter.

There are several ways to specify which tracks or episodes to remove, determined by the request parameters. Removing all occurrences of specific items:
[{ "uri": "spotify:track:4iV5W9uYEdYUVa79Axb7Rh" }, {"uri": "spotify:episode:512ojhOuo1ktJprKbVcKyQ" }]
Removing a specific occurrence of an item:
[{ "uri": "spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "positions": [0,3] }, { "uri": "spotify:track:1301WleyT98MSxVHPZCA6M", "positions": [7] }]

Parameters:

tracks - Required. An array of objects containing Spotify URIs of the items to remove. A maximum of 100 objects can be sent at once

Returns:

A RemovePlaylistItemsRequest.Builder.

See Also:

• Spotify: URIs & IDs

snapshotId

public RemovePlaylistItemsRequest.Builder snapshotId(String snapshotId)

The playlist snapshot ID setter.

To guard against errors when concurrent edits happen to the same playlist, we recommend specifying a snapshot ID. The snapshot ID lets us know which version of the playlist you are trying to edit. Concurrent edits by another user will be automatically resolved. If a given item in a given position is not found in the specified snapshot, the entire request will fail an no edits will take place.

Parameters:

snapshotId - Optional. The playlist's snapshot ID against which you want to make the changes. The API will validate that the specified items exist and in the specified positions and make the changes, even if more recent changes have been made to the playlist.

Returns:

A RemovePlaylistItemsRequest.Builder.

See Also:

• Spotify: Version Control and Snapshots

build

public RemovePlaylistItemsRequest build()

The request build method.

Returns:

A custom RemovePlaylistItemsRequest.

self

protected RemovePlaylistItemsRequest.Builder self()

Description copied from class: AbstractRequest.Builder

Return this instance to simulate a self-type.

Specified by:

self in class AbstractRequest.Builder<SnapshotResult, RemovePlaylistItemsRequest.Builder>

Returns:

This instance.