diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index ade9eec7c..61ca8b462 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -53,7 +53,7 @@ jobs: env: GPG_KEY_NAME: B70E1EAC GPG_PASSPHRASE_FILE: ${{ secrets.GPG_PASSPHRASE_FILE }} - GPG_PASSPHRASE_KEY: ${{ secrets.GPG_PASSPHRASE_KEY }} + MAVEN_GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE_KEY }} SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }} SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }} run: | diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..da9c66344 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,111 @@ +# AGENTS.md + +This file provides context for AI coding agents working in this repository. + +## Project Overview + +**spotify-web-api-java** is a Java wrapper library for the [Spotify Web API](https://developer.spotify.com/documentation/web-api/). It provides typed request builders and model objects for all Spotify API endpoints. + +- **Group ID:** `se.michaelthelin.spotify` +- **Artifact ID:** `spotify-web-api-java` +- **Current Version:** `10.0.0-RC1` +- **Build Tool:** Maven (`pom.xml`) +- **Java Version:** 17+ + +## Repository Structure + +``` +src/ +├── main/java/se/michaelthelin/spotify/ +│ ├── SpotifyApi.java # Main entry point – all endpoint builders exposed here +│ ├── SpotifyHttpManager.java # HTTP client wrapper +│ ├── enums/ # Enum types (ModelObjectType, etc.) +│ ├── exceptions/ # Exception hierarchy +│ ├── model_objects/ # POJOs for API response objects +│ │ ├── specification/ # Core model objects (Playlist, Track, Album, etc.) +│ │ ├── special/ # Composite/special models +│ │ └── miscellaneous/ # Supporting models +│ └── requests/ +│ └── data/ # One subfolder per API category +│ ├── albums/ +│ ├── artists/ +│ ├── playlists/ # Playlist endpoint request classes +│ └── ... +└── test/ + ├── java/se/michaelthelin/spotify/ + │ ├── ITest.java # Shared test constants (IDs, names, etc.) + │ ├── TestUtil.java # Mock HTTP manager helpers + │ └── requests/data/ # Unit tests mirroring main structure + └── fixtures/requests/data/ # JSON fixture files for mock HTTP responses +``` + +## Adding a New Endpoint + +To add a new Spotify API endpoint, follow these steps: + +### 1. Create a Request class + +Create `src/main/java/se/michaelthelin/spotify/requests/data//Request.java`. + +Key patterns: +- Extend `AbstractDataRequest` (or `AbstractDataPagingRequest` for paginated results). +- Annotate with `@JsonDeserialize(builder = .Builder.class)`. +- Implement `execute()` which calls `getJson()`, `postJson()`, `putJson()`, or `deleteJson()` as appropriate. +- Add a `static final class Builder` with: + - Path parameters set via `setPathParameter("key", value)` + - Query parameters set via `setQueryParameter("key", value)` + - Body parameters set via `setBodyParameter("key", value)` + - `build()` method that calls `setPath("/v1/...")` and `setContentType(...)` for POST/PUT requests + - `self()` returning `this` + +**Endpoint URL reference:** Use the new `POST /v1/me/playlists` style paths (not the older `/v1/users/{user_id}/...` style where Spotify has migrated endpoints). + +### 2. Expose the method in SpotifyApi + +In `SpotifyApi.java`, add a public method that: +- Returns `Request.Builder` +- Creates a new builder via `new Request.Builder(accessToken)` +- Chains `.setDefaults(httpManager, scheme, host, port)` +- Sets any required path parameters + +Methods are grouped by API category (albums, artists, playlists, etc.). + +### 3. Add a fixture file + +Create `src/test/fixtures/requests/data//Request.json` with a sample API response. + +### 4. Add a test class + +Create `src/test/java/se/michaelthelin/spotify/requests/data//RequestTest.java`. + +Extend `AbstractDataTest`. Tests should: +- Verify the built URI using `assertEquals("https://api.spotify.com:443/v1/...", request.getUri().toString())` +- Verify headers with `assertHasHeader(...)` and `assertHasAuthorizationHeader(...)` +- Verify body parameters with `assertHasBodyParameter(...)` (from `se.michaelthelin.spotify.Assertions`) +- Verify the deserialized response via `shouldReturnDefault(...)` for both sync and async execution + +Common test constants are in `ITest.java` (e.g., `ITest.NAME`, `ITest.ID_PLAYLIST`, `ITest.PUBLIC`). + +## Building and Testing + +```bash +# Compile +mvn compile + +# Run all tests +mvn test + +# Run a specific test class +mvn test -Dtest="CreatePlaylistRequestTest" + +# Run tests matching a pattern +mvn test -Dtest="*Playlist*" +``` + +## Key Conventions + +- **Trailing underscores** on Java-reserved words: e.g., `public_` for the `public` field. +- **Assertions** in tests are imported from both JUnit 5 (`org.junit.jupiter.api.Assertions`) and the project's own `se.michaelthelin.spotify.Assertions`. +- **Nullable fields** from the API should be tested with `assertNull(...)` when the fixture returns `null`. +- **POST/PUT** requests must set `ContentType.APPLICATION_JSON` in the `build()` method. +- **Path patterns** use `{param_name}` placeholders set with `setPathParameter("param_name", value)`. diff --git a/README.md b/README.md index b588e804f..0f735f3d1 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ Latest official release: se.michaelthelin.spotify spotify-web-api-java - 9.4.0 + 10.0.0-RC3 ``` @@ -52,7 +52,7 @@ Latest snapshot: Latest official release: ```Gradle -implementation 'se.michaelthelin.spotify:spotify-web-api-java:9.4.0' +implementation 'se.michaelthelin.spotify:spotify-web-api-java:10.0.0-RC3' ``` Latest snapshot: @@ -222,132 +222,134 @@ access token only once, after which it becomes invalid. ## Examples + +> **Deprecated** examples are marked with ⚠️ and will be removed in v11.0. See [MIGRATION.md](MIGRATION.md) for alternatives. + - **Albums** - [Get an Album](examples/data/albums/GetAlbumExample.java) - [Get an Album's Tracks](examples/data/albums/GetAlbumsTracksExample.java) - - [Get several Albums](examples/data/albums/GetSeveralAlbumsExample.java) + - [Check User's Saved Albums](examples/data/albums/CheckUsersSavedAlbumsExample.java) + - [Get Current User's Saved Albums](examples/data/albums/GetCurrentUsersSavedAlbumsExample.java) - **Artists** - [Get an Artist](examples/data/artists/GetArtistExample.java) - [Get an Artist's Albums](examples/data/artists/GetArtistsAlbumsExample.java) - - [Get an Artist's Top Tracks](examples/data/artists/GetArtistsTopTracksExample.java) - [Get an Artist's Related Artists](examples/data/artists/GetArtistsRelatedArtistsExample.java) - - [Get Several Artists](examples/data/artists/GetSeveralArtistsExample.java) + - ⚠️ [Get an Artist's Top Tracks](examples/data/artists/) — deprecated; use search instead + + +- **Audiobooks** + - [Get an Audiobook](examples/data/audiobooks/GetAudiobookExample.java) + - [Get an Audiobook's Chapters](examples/data/audiobooks/GetAudiobookChaptersExample.java) + - ⚠️ [Get Several Audiobooks](examples/data/audiobooks/GetSeveralAudiobooksExample.java) + - ⚠️ [Get User's Saved Audiobooks](examples/data/audiobooks/GetUsersSavedAudiobooksExample.java) + - ⚠️ [Check User's Saved Audiobooks](examples/data/audiobooks/CheckUsersSavedAudiobooksExample.java) + - ⚠️ [Save Audiobooks for Current User](examples/data/audiobooks/SaveAudiobooksForCurrentUserExample.java) + - ⚠️ [Remove Audiobooks for Current User](examples/data/audiobooks/RemoveAudiobooksForCurrentUserExample.java) + + +- **Browsing & Discovery** + - [Get Available Genre Seeds](examples/data/genres/GetAvailableGenreSeedsExample.java) + - ⚠️ [Get Categories](examples/data/categories/GetSeveralBrowseCategoriesExample.java) + - ⚠️ [Get a Category](examples/data/categories/GetSingleBrowseCategoryExample.java) + - ⚠️ [Get a Category's Playlists](examples/data/playlists/GetCategoryPlaylistsExample.java) + - ⚠️ [Get Featured Playlists](examples/data/playlists/GetFeaturedPlaylistsExample.java) + - ⚠️ [Get Available Markets](examples/data/markets/GetAvailableMarketsExample.java) -- **Browse** - - Miscellaneous - - [Get Available Genre Seeds](examples/data/browse/miscellaneous/GetAvailableGenreSeedsExample.java) - - [Get a Category](examples/data/browse/GetCategoryExample.java) - - [Get a Category's Playlists](examples/data/browse/GetCategorysPlaylistsExample.java) - - [Get a List of Categories](examples/data/browse/GetListOfCategoriesExample.java) - - [Get a List of Featured Playlists](examples/data/browse/GetListOfFeaturedPlaylistsExample.java) - - [Get a List of New Releases](examples/data/browse/GetListOfNewReleasesExample.java) - - [Get Recommendations](examples/data/browse/GetRecommendationsExample.java) +- **Chapters** + - [Get a Chapter](examples/data/chapters/GetChapterExample.java) + - ⚠️ [Get Several Chapters](examples/data/chapters/GetSeveralChaptersExample.java) - **Episodes** - [Get an Episode](examples/data/episodes/GetEpisodeExample.java) - - [Get several Episodes](examples/data/episodes/GetSeveralEpisodesExample.java) - - -- **Follow** - - [Check if Current User Follows Artists or Users](examples/data/follow/CheckCurrentUserFollowsArtistsOrUsersExample.java) - - [Check if Users Follow a Playlist](examples/data/follow/CheckUsersFollowPlaylistExample.java) - - [Follow Artists or Users](examples/data/follow/FollowArtistsOrUsersExample.java) - - [Follow a Playlist](examples/data/follow/FollowPlaylistExample.java) - - [Get User's Followed Artists](examples/data/follow/GetUsersFollowedArtistsExample.java) - - [Unfollow Artists or Users](examples/data/follow/UnfollowArtistsOrUsersExample.java) - - [Unfollow a Playlist](examples/data/follow/UnfollowPlaylistExample.java) - - -- **Library** - - [Check User's Saved Albums](examples/data/library/CheckUsersSavedAlbumsExample.java) - - [Check User's Saved Episodes](examples/data/library/CheckUsersSavedEpisodesExample.java) - - [Check User's Saved Shows](examples/data/library/CheckUsersSavedShowsExample.java) - - [Check User's Saved Tracks](examples/data/library/CheckUsersSavedTracksExample.java) - - [Get Current User's Saved Albums](examples/data/library/GetCurrentUsersSavedAlbumsExample.java) - - [Get User's Saved Episodes](examples/data/library/GetUsersSavedEpisodesExample.java) - - [Get User's Saved Shows](examples/data/library/GetUsersSavedShowsExample.java) - - [Get User's Saved Tracks](examples/data/library/GetUsersSavedTracksExample.java) - - [Remove Albums for Current User](examples/data/library/RemoveAlbumsForCurrentUserExample.java) - - [Remove User's Saved Episodes](examples/data/library/RemoveUsersSavedEpisodesExample.java) - - [Remove User's Saved Shows](examples/data/library/RemoveUsersSavedShowsExample.java) - - [Remove User's Saved Tracks](examples/data/library/RemoveUsersSavedTracksExample.java) - - [Save Albums for Current User](examples/data/library/SaveAlbumsForCurrentUserExample.java) - - [Save Episodes for Current User](examples/data/library/SaveEpisodesForCurrentUserExample.java) - - [Save Shows for Current User](examples/data/library/SaveShowsForCurrentUserExample.java) - - [Save Tracks for User](examples/data/library/SaveTracksForUserExample.java) + - [Check User's Saved Episodes](examples/data/episodes/CheckUsersSavedEpisodesExample.java) + - [Get User's Saved Episodes](examples/data/episodes/GetUsersSavedEpisodesExample.java) + + +- **Library (Unified Save/Remove/Check API)** + - [Save Items to Library](examples/data/library/SaveToLibraryExample.java) + - [Remove Items from Library](examples/data/library/RemoveFromLibraryExample.java) - **Personalization** + - [Get a User's Top Artists and Tracks](examples/data/users/GetUsersTopArtistsAndTracksExample.java) - Simplified - - [Get a User's Top Artists](examples/data/personalization/simplified/GetUsersTopArtistsExample.java) - - [Get a User's Top Tracks](examples/data/personalization/simplified/GetUsersTopTracksExample.java) - - [Get a User's Top Artists and Tracks](examples/data/personalization/GetUsersTopArtistsAndTracksExample.java) + - [Get a User's Top Artists](examples/data/users/simplified/GetUsersTopArtistsExample.java) + - [Get a User's Top Tracks](examples/data/users/simplified/GetUsersTopTracksExample.java) - **Player** - - [Add Item to User's Playback Queue](examples/data/player/AddItemToUsersPlaybackQueueExample.java) - - [Get a User's Available Devices](examples/data/player/GetUsersAvailableDevicesExample.java) - - [Get Information About The User's Current Playback](examples/data/player/GetInformationAboutUsersCurrentPlaybackExample.java) - - [Get Current User's Recently Played Tracks](examples/data/player/GetCurrentUsersRecentlyPlayedTracksExample.java) - - [Get the User's Currently Playing Track](examples/data/player/GetUsersCurrentlyPlayingTrackExample.java) - - [Pause a User's Playback](examples/data/player/PauseUsersPlaybackExample.java) - - [Seek To Position In Currently Playing Track](examples/data/player/SeekToPositionInCurrentlyPlayingTrackExample.java) - - [Set Repeat Mode On User's Playback](examples/data/player/SetRepeatModeOnUsersPlaybackExample.java) - - [Set Volume For User's Playback](examples/data/player/SetVolumeForUsersPlaybackExample.java) - - [Skip User's Playback To Next Track](examples/data/player/SkipUsersPlaybackToNextTrackExample.java) - - [Skip User's Playback To Previous Track](examples/data/player/SkipUsersPlaybackToPreviousTrackExample.java) - - [Start/Resume a User's Playback](examples/data/player/StartResumeUsersPlaybackExample.java) - - [Toggle Shuffle For User's Playback](examples/data/player/ToggleShuffleForUsersPlaybackExample.java) - - [Transfer a User's Playback](examples/data/player/TransferUsersPlaybackExample.java) + - [Get Available Devices](examples/data/player/GetUsersAvailableDevicesExample.java) + - [Get Current Playback State](examples/data/player/GetInformationAboutUsersCurrentPlaybackExample.java) + - [Get Currently Playing Track](examples/data/player/GetUsersCurrentlyPlayingTrackExample.java) + - [Get Recently Played Tracks](examples/data/player/GetCurrentUsersRecentlyPlayedTracksExample.java) + - [Get User's Queue](examples/data/player/GetTheUsersQueueExample.java) + - [Start/Resume Playback](examples/data/player/StartResumeUsersPlaybackExample.java) + - [Pause Playback](examples/data/player/PauseUsersPlaybackExample.java) + - [Skip to Next Track](examples/data/player/SkipUsersPlaybackToNextTrackExample.java) + - [Skip to Previous Track](examples/data/player/SkipUsersPlaybackToPreviousTrackExample.java) + - [Seek to Position](examples/data/player/SeekToPositionInCurrentlyPlayingTrackExample.java) + - [Set Repeat Mode](examples/data/player/SetRepeatModeOnUsersPlaybackExample.java) + - [Toggle Shuffle](examples/data/player/ToggleShuffleForUsersPlaybackExample.java) + - [Set Volume](examples/data/player/SetVolumeForUsersPlaybackExample.java) + - [Transfer Playback](examples/data/player/TransferUsersPlaybackExample.java) + - [Add Item to Queue](examples/data/player/AddItemToUsersPlaybackQueueExample.java) - **Playlists** - - [Add Items to a Playlist](examples/data/playlists/AddItemsToPlaylistExample.java) - - [Change a Playlist's Details](examples/data/playlists/ChangePlaylistsDetailsExample.java) - - [Create a Playlist](examples/data/playlists/CreatePlaylistExample.java) - - [Get a List of Current User's Playlists](examples/data/playlists/GetListOfCurrentUsersPlaylistsExample.java) - - [Get a List of a User's Playlists](examples/data/playlists/GetListOfUsersPlaylistsExample.java) - [Get a Playlist](examples/data/playlists/GetPlaylistExample.java) - - [Get a Playlist Cover Image](examples/data/playlists/GetPlaylistCoverImageExample.java) + - [Get Current User's Playlists](examples/data/playlists/GetCurrentUsersPlaylistsExample.java) - [Get a Playlist's Items](examples/data/playlists/GetPlaylistsItemsExample.java) + - [Get a Playlist Cover Image](examples/data/playlists/GetPlaylistCoverImageExample.java) + - [Add Items to a Playlist](examples/data/playlists/AddItemsToPlaylistExample.java) - [Remove Items from a Playlist](examples/data/playlists/RemoveItemsFromPlaylistExample.java) - - [Reorder a Playlist's Items](examples/data/playlists/ReorderPlaylistsItemsExample.java) - - [Replace a Playlist's Items](examples/data/playlists/ReplacePlaylistsItemsExample.java) - - [Upload a Custom Playlist Cover Image](examples/data/playlists/UploadCustomPlaylistCoverImageExample.java) + - [Update Playlist Details](examples/data/playlists/ChangePlaylistsDetailsExample.java) + - [Reorder Playlist Items](examples/data/playlists/UpdatePlaylistsItemsReorderExample.java) + - [Replace Playlist Items](examples/data/playlists/UpdatePlaylistsItemsReplaceExample.java) + - [Upload Playlist Cover Image](examples/data/playlists/UploadCustomPlaylistCoverImageExample.java) + - ⚠️ [Add Items (Deprecated Format)](examples/data/playlists/AddItemsToPlaylistDeprecatedExample.java) - **Search** - - Simplified + - [Search for Item](examples/data/search/SearchItemExample.java) + - Simplified (Direct Type Search) - [Search Albums](examples/data/search/simplified/SearchAlbumsExample.java) - [Search Artists](examples/data/search/simplified/SearchArtistsExample.java) + - [Search Tracks](examples/data/search/simplified/SearchTracksExample.java) + - [Search Shows](examples/data/search/simplified/SearchShowsExample.java) - [Search Episodes](examples/data/search/simplified/SearchEpisodesExample.java) - [Search Playlists](examples/data/search/simplified/SearchPlaylistsExample.java) - - [Search Shows](examples/data/search/simplified/SearchShowsExample.java) - - [Search Tracks](examples/data/search/simplified/SearchTracksExample.java) - - [Search Item](examples/data/search/SearchItemExample.java) - **Shows** - [Get a Show](examples/data/shows/GetShowExample.java) - - [Get several Show](examples/data/shows/GetSeveralShowsExample.java) - [Get a Show's Episodes](examples/data/shows/GetShowsEpisodesExample.java) + - [Check User's Saved Shows](examples/data/shows/CheckUsersSavedShowsExample.java) + - [Get User's Saved Shows](examples/data/shows/GetUsersSavedShowsExample.java) - **Tracks** - - [Get Audio Analysis for a Track](examples/data/tracks/GetAudioAnalysisForTrackExample.java) + - [Get a Track](examples/data/tracks/GetTrackExample.java) + - [Check User's Saved Tracks](examples/data/tracks/CheckUsersSavedTracksExample.java) + - [Get User's Saved Tracks](examples/data/tracks/GetUsersSavedTracksExample.java) - [Get Audio Features for a Track](examples/data/tracks/GetAudioFeaturesForTrackExample.java) - [Get Audio Features for Several Tracks](examples/data/tracks/GetAudioFeaturesForSeveralTracksExample.java) - - [Get Several Tracks](examples/data/tracks/GetSeveralTracksExample.java) - - [Get a Track](examples/data/tracks/GetTrackExample.java) - - -- **User's Profile** - - [Get Current User's Profile](examples/data/users_profile/GetCurrentUsersProfileExample.java) - - [Get a User's Profile](examples/data/users_profile/GetUsersProfileExample.java) + - [Get Audio Analysis for a Track](examples/data/tracks/GetAudioAnalysisForTrackExample.java) + - [Get Recommendations](examples/data/tracks/GetRecommendationsExample.java) + + +- **User's Profile & Following** + - [Get Current User's Profile](examples/data/users/GetCurrentUsersProfileExample.java) + - ⚠️ [Get User's Followed Artists](examples/data/users/GetUsersFollowedArtistsExample.java) + - ⚠️ [Follow Artists or Users](examples/data/users/FollowArtistsOrUsersExample.java) + - ⚠️ [Unfollow Artists or Users](examples/data/users/UnfollowArtistsOrUsersExample.java) + - ⚠️ [Check if User Follows Artists or Users](examples/data/users/CheckCurrentUserFollowsArtistsOrUsersExample.java) + - ⚠️ [Follow a Playlist](examples/data/users/FollowPlaylistExample.java) + - ⚠️ [Unfollow a Playlist](examples/data/users/UnfollowPlaylistExample.java) + - ⚠️ [Check if Users Follow a Playlist](examples/data/users/CheckUsersFollowPlaylistExample.java) ## Contributions See [CONTRIBUTING.md](CONTRIBUTING.md). diff --git a/apidocs/allclasses-index.html b/apidocs/allclasses-index.html index fa4f4d8de..23d3c9cb4 100644 --- a/apidocs/allclasses-index.html +++ b/apidocs/allclasses-index.html @@ -1,53 +1,52 @@ - -All Classes and Interfaces (Spotify Web API Java Client 9.4.0 API) + +All Classes and Interfaces (Spotify Web API Java Client 10.0.0-RC3 API) - + - - - - - + + + + + - -
-

  • getUsersSavedTracks

    +
    public GetUsersSavedTracksRequest.Builder getUsersSavedTracks()
    Get an user's "Your Music" tracks.
    Returns:
    A GetUsersSavedTracksRequest.Builder.
    +
  • -
    -

    removeAlbumsForCurrentUser

    -
    public RemoveAlbumsForCurrentUserRequest.Builder removeAlbumsForCurrentUser(String... ids)
    -
    Remove one or more albums from the current user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - A list of the Spotify IDs. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeAlbumsForCurrentUser

    -
    public RemoveAlbumsForCurrentUserRequest.Builder removeAlbumsForCurrentUser(com.google.gson.JsonArray ids)
    -
    Remove one or more albums from the current user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs for the albums to be deleted. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedShows

    -
    public RemoveUsersSavedShowsRequest.Builder removeUsersSavedShows(String... ids)
    -
    Remove one or more shows from the current users "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs for the shows to be deleted. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedShows

    -
    public RemoveUsersSavedShowsRequest.Builder removeUsersSavedShows(com.google.gson.JsonArray ids)
    -
    Remove one or more shows from the current users "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs for the shows to be deleted. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedEpisodes

    -
    public RemoveUsersSavedEpisodesRequest.Builder removeUsersSavedEpisodes(String... ids)
    -
    Remove one or more episodes from the current user's library. - This endpoint is in beta and could change without warning.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs for the episodes to be removed. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveUsersSavedEpisodesRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedEpisodes

    -
    public RemoveUsersSavedEpisodesRequest.Builder removeUsersSavedEpisodes(com.google.gson.JsonArray ids)
    -
    Remove one or more episodes from the current user's library. - This endpoint is in beta and could change without warning.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs for the episodes to be removed. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveUsersSavedEpisodesRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedTracks

    -
    public RemoveUsersSavedTracksRequest.Builder removeUsersSavedTracks(String... ids)
    -
    Remove a track if saved to the user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The track IDs to remove from the user's Your Music library. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveUsersSavedTracksRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    removeUsersSavedTracks

    -
    public RemoveUsersSavedTracksRequest.Builder removeUsersSavedTracks(com.google.gson.JsonArray ids)
    -
    Remove a track if saved to the user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The track IDs to remove from the user's Your Music library. Maximum: 50 IDs.
    -
    Returns:
    -
    A RemoveUsersSavedTracksRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveAlbumsForCurrentUser

    -
    public SaveAlbumsForCurrentUserRequest.Builder saveAlbumsForCurrentUser(String... ids)
    -
    Save albums in the user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The album IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveAlbumsForCurrentUser

    -
    public SaveAlbumsForCurrentUserRequest.Builder saveAlbumsForCurrentUser(com.google.gson.JsonArray ids)
    -
    Save albums in the user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The album IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveAlbumsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveShowsForCurrentUser

    -
    public SaveShowsForCurrentUserRequest.Builder saveShowsForCurrentUser(String... ids)
    -
    Save one or more shows to current Spotify user’s library.
    -
    -
    Parameters:
    -
    ids - The show IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveShowsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveShowsForCurrentUser

    -
    public SaveShowsForCurrentUserRequest.Builder saveShowsForCurrentUser(com.google.gson.JsonArray ids)
    -
    Save one or more shows to current Spotify user’s library.
    -
    -
    Parameters:
    -
    ids - The show IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveShowsForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveEpisodesForCurrentUser

    -
    public SaveEpisodesForCurrentUserRequest.Builder saveEpisodesForCurrentUser(String... ids)
    -
    Save one or more episodes to the current user's library. - This endpoint is in beta and could change without warning.
    -
    -
    Parameters:
    -
    ids - The episode IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveEpisodesForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveEpisodesForCurrentUser

    -
    public SaveEpisodesForCurrentUserRequest.Builder saveEpisodesForCurrentUser(com.google.gson.JsonArray ids)
    -
    Save one or more episodes to the current user's library. - This endpoint is in beta and could change without warning.
    +
    +

    saveToLibrary

    +
    +
    public SaveToLibraryRequest.Builder saveToLibrary(com.google.gson.JsonArray uris)
    +
    Save a list of Spotify URIs to the user's library.
    Parameters:
    -
    ids - The episode IDs to add to the user's library. Maximum: 50 IDs.
    +
    uris - The Spotify URIs to save. Maximum: 50 URIs.
    Returns:
    -
    A SaveEpisodesForCurrentUserRequest.Builder.
    -
    See Also:
    -
    - -
    -
    -
    -
    • -
  • -
    -

    saveTracksForUser

    -
    public SaveTracksForUserRequest.Builder saveTracksForUser(String... ids)
    -
    Save tracks in the user's "Your Music" library.
    -
    -
    Parameters:
    -
    ids - The track IDs to add to the user's library. Maximum: 50 IDs.
    -
    Returns:
    -
    A SaveTracksForUserRequest.Builder.
    -
    See Also:
    -
    - -
    +
    A SaveToLibraryRequest.Builder.
    +
  • -
    -

    saveTracksForUser

    -
    public SaveTracksForUserRequest.Builder saveTracksForUser(com.google.gson.JsonArray ids)
    -
    Save tracks in the user's "Your Music" library.
    +
    +

    removeFromLibrary

    +
    +
    public RemoveFromLibraryRequest.Builder removeFromLibrary(com.google.gson.JsonArray uris)
    +
    Remove a list of Spotify URIs from the user's library.
    Parameters:
    -
    ids - The track IDs to add to the user's library. Maximum: 50 IDs.
    +
    uris - The Spotify URIs to remove. Maximum: 50 URIs.
    Returns:
    -
    A SaveTracksForUserRequest.Builder.
    -
    See Also:
    -
    - -
    +
    A RemoveFromLibraryRequest.Builder.
    +

  • getUsersTopArtistsAndTracks

    +
    public <T extends IArtistTrackModelObject> GetUsersTopArtistsAndTracksRequest.Builder<T> getUsersTopArtistsAndTracks(ModelObjectType type)
    Get the current user's top artists or tracks based on calculated affinity.

    -

    - Affinity is a measure of the expected preference an user has for a particular track or artist. It is based on user - behavior, including play history, but does not include actions made while in incognito mode. Light or infrequent - users of Spotify may not have sufficient play history to generate a full affinity data set.

    +

    +Affinity is a measure of the expected preference an user has for a particular track or artist. It is based on user +behavior, including play history, but does not include actions made while in incognito mode. Light or infrequent +users of Spotify may not have sufficient play history to generate a full affinity data set.

    Type Parameters:
    -
    T - Either Artist or - Track
    +
    T - Either Artist or + Track
    Parameters:
    type - The type of entity to return. Valid values: artists or tracks.
    Returns:
    A GetUsersTopArtistsAndTracksRequest.Builder.
    +

  • getUsersTopArtists

    +
    public GetUsersTopArtistsRequest.Builder getUsersTopArtists()
    Get the current user's top artists based on calculated affinity.
    @@ -2514,11 +2242,13 @@

    getUsersTopArtists

    +

  • getUsersTopTracks

    +
    public GetUsersTopTracksRequest.Builder getUsersTopTracks()
    Get the current user's top tracks based on calculated affinity.
    @@ -2531,100 +2261,116 @@

    getUsersTopTracks

    +

  • getInformationAboutUsersCurrentPlayback

    +
    public GetInformationAboutUsersCurrentPlaybackRequest.Builder getInformationAboutUsersCurrentPlayback()
    Get information about the user's current playback state, including context, track progress, and active device.
    Returns:
    A GetInformationAboutUsersCurrentPlaybackRequest.Builder.
    +

  • getCurrentUsersRecentlyPlayedTracks

    +
    public GetCurrentUsersRecentlyPlayedTracksRequest.Builder getCurrentUsersRecentlyPlayedTracks()
    Get tracks from the current user's recently played tracks.

    -

    - Returns the most recent 50 tracks played by an user. Note that a track currently playing will not be visible in play - history until it has completed. A track must be played for more than 30 seconds to be included in play history. -

    - Any tracks listened to while the user had "Private Session" enabled in their client will not be returned in the - list of recently played tracks.

    +

    +Returns the most recent 50 tracks played by an user. Note that a track currently playing will not be visible in play +history until it has completed. A track must be played for more than 30 seconds to be included in play history. +

    +Any tracks listened to while the user had "Private Session" enabled in their client will not be returned in the +list of recently played tracks.

    Returns:
    A GetCurrentUsersRecentlyPlayedTracksRequest.Builder.
    +

  • getUsersAvailableDevices

    +
    public GetUsersAvailableDevicesRequest.Builder getUsersAvailableDevices()
    Get information about an user's available devices.
    Returns:
    A GetUsersAvailableDevicesRequest.Builder.
    +

  • getUsersCurrentlyPlayingTrack

    +
    public GetUsersCurrentlyPlayingTrackRequest.Builder getUsersCurrentlyPlayingTrack()
    Get the object currently being played on the user's Spotify account.
    Returns:
    A GetUsersCurrentlyPlayingTrackRequest.Builder.
    +

  • pauseUsersPlayback

    +
    public PauseUsersPlaybackRequest.Builder pauseUsersPlayback()
    Pause playback on the user's account.
    Returns:
    A PauseUsersPlaybackRequest.Builder.
    +

  • seekToPositionInCurrentlyPlayingTrack

    +
    public SeekToPositionInCurrentlyPlayingTrackRequest.Builder seekToPositionInCurrentlyPlayingTrack(int position_ms)
    Seeks to the given position in the user's currently playing track.
    Parameters:
    position_ms - The position in milliseconds to seek to. Must be a positive number. Passing in a position that - is greater than the length of the track will cause the player to start playing the next song.
    + is greater than the length of the track will cause the player to start playing the next song.
    Returns:
    A SeekToPositionInCurrentlyPlayingTrackRequest.Builder.
    +

  • setRepeatModeOnUsersPlayback

    -
    public SetRepeatModeOnUsersPlaybackRequest.Builder setRepeatModeOnUsersPlayback(String state)
    +
    +
    public SetRepeatModeOnUsersPlaybackRequest.Builder setRepeatModeOnUsersPlayback(String state)
    Set the repeat mode for the user's playback. Options are repeat-track, repeat-context, and off.
    Parameters:
    state - track, context or off. track will repeat the current track. context will repeat the current - context. off will turn repeat off.
    + context. off will turn repeat off.
    Returns:
    A SetRepeatModeOnUsersPlaybackRequest.Builder.
    +

  • setVolumeForUsersPlayback

    +
    public SetVolumeForUsersPlaybackRequest.Builder setVolumeForUsersPlayback(int volume_percent)
    Set the volume for the user's current playback device.
    @@ -2633,48 +2379,56 @@

    setVolumeForUsersPlayback

    Returns:
    A SetVolumeForUsersPlaybackRequest.Builder.
    +

  • skipUsersPlaybackToNextTrack

    +
    public SkipUsersPlaybackToNextTrackRequest.Builder skipUsersPlaybackToNextTrack()
    Skips to next track in the user's queue.
    Returns:
    A SkipUsersPlaybackToNextTrackRequest.Builder.
    +

  • skipUsersPlaybackToPreviousTrack

    +
    public SkipUsersPlaybackToPreviousTrackRequest.Builder skipUsersPlaybackToPreviousTrack()
    Skips to previous track in the user's queue. -

    - Note: This will ALWAYS skip to the previous track, regardless of the current track’s progress. Returning to - the start of the current track should be performed using the seekToPositionInCurrentlyPlayingTrack(int) - method.

    +

    +Note: This will ALWAYS skip to the previous track, regardless of the current track’s progress. Returning to +the start of the current track should be performed using the seekToPositionInCurrentlyPlayingTrack(int) +method.

    Returns:
    A SkipUsersPlaybackToPreviousTrackRequest.Builder.
    +

  • startResumeUsersPlayback

    +
    public StartResumeUsersPlaybackRequest.Builder startResumeUsersPlayback()
    Start a new context or resume current playback on the user's active device.
    Returns:
    A StartResumeUsersPlaybackRequest.Builder.
    +

  • toggleShuffleForUsersPlayback

    +
    public ToggleShuffleForUsersPlaybackRequest.Builder toggleShuffleForUsersPlayback(boolean state)
    Toggle shuffle on or off for user's playback.
    @@ -2683,26 +2437,30 @@

    toggleShuffleForUsersPlayback

    Returns:
    A ToggleShuffleForUsersPlaybackRequest.Builder.
    +

  • transferUsersPlayback

    +
    public TransferUsersPlaybackRequest.Builder transferUsersPlayback(com.google.gson.JsonArray device_ids)
    Transfer playback to a new device and determine if it should start playing.
    Parameters:
    device_ids - A JSON array containing the ID of the device on which playback should be started/transferred. -
    Note: Although an array is accepted, only a single device_id is currently supported.
    +
    Note: Although an array is accepted, only a single device_id is currently supported.
    Returns:
    A TransferUsersPlaybackRequest.Builder.
    +

  • addItemToUsersPlaybackQueue

    -
    public AddItemToUsersPlaybackQueueRequest.Builder addItemToUsersPlaybackQueue(String uri)
    +
    +
    public AddItemToUsersPlaybackQueueRequest.Builder addItemToUsersPlaybackQueue(String uri)
    Add a track or an episode to the end of the user's current playback queue.
    Parameters:
    @@ -2716,28 +2474,32 @@

    addItemToUsersPlaybackQueue

    +

  • getTheUsersQueue

    +
    public GetTheUsersQueueRequest.Builder getTheUsersQueue()
    Receive all items from the user's current playback queue.
    Returns:
    An GetTheUsersQueueRequest.Builder.
    +

  • addItemsToPlaylist

    -
    public AddItemsToPlaylistRequest.Builder addItemsToPlaylist(String playlist_id, - String[] uris)
    +
    +
    public AddItemsToPlaylistRequest.Builder addItemsToPlaylist(String playlist_id, + String[] uris)
    Add items to a playlist. -

    - Note: If you want to add a large number of items (>50), use addItemsToPlaylist(String, JsonArray) to not exceed - the maximum URI length.

    +

    +Note: If you want to add a large number of items (>50), use addItemsToPlaylist(String, JsonArray) to not exceed +the maximum URI length.

    Parameters:
    playlist_id - The playlists ID.
    @@ -2751,12 +2513,14 @@

    addItemsToPlaylist

    +

  • addItemsToPlaylist

    -
    public AddItemsToPlaylistRequest.Builder addItemsToPlaylist(String playlist_id, +
    +
    public AddItemsToPlaylistRequest.Builder addItemsToPlaylist(String playlist_id, com.google.gson.JsonArray uris)
    Add items to a playlist.
    @@ -2772,12 +2536,14 @@

    addItemsToPlaylist

    +

  • changePlaylistsDetails

    -
    public ChangePlaylistsDetailsRequest.Builder changePlaylistsDetails(String playlist_id)
    +
    +
    public ChangePlaylistsDetailsRequest.Builder changePlaylistsDetails(String playlist_id)
    Update a playlists properties.
    Parameters:
    @@ -2791,63 +2557,42 @@

    changePlaylistsDetails

    +
  • -
    +

    createPlaylist

    -
    public CreatePlaylistRequest.Builder createPlaylist(String user_id, - String name)
    -
    Create a playlist.
    +
    +
    public CreatePlaylistRequest.Builder createPlaylist(String name)
    +
    Create a playlist for the current Spotify user.
    Parameters:
    -
    user_id - The playlists owner.
    -
    name - The name of the playlist.
    +
    name - The name for the new playlist.
    Returns:
    A CreatePlaylistRequest.Builder.
    -
    See Also:
    -
    - -
    +

  • getListOfCurrentUsersPlaylists

    +
    public GetListOfCurrentUsersPlaylistsRequest.Builder getListOfCurrentUsersPlaylists()
    Get a list of the playlists owned or followed by the current Spotify user.
    Returns:
    A GetListOfCurrentUsersPlaylistsRequest.Builder.
    -
    -
    • -
  • -
    -

    getListOfUsersPlaylists

    -
    public GetListOfUsersPlaylistsRequest.Builder getListOfUsersPlaylists(String user_id)
    -
    Get an user's playlists.
    -
    -
    Parameters:
    -
    user_id - A Spotify ID of the user.
    -
    Returns:
    -
    A GetListOfUsersPlaylistsRequest.Builder.
    -
    See Also:
    -
    - -
    -
    +

  • getPlaylist

    -
    public GetPlaylistRequest.Builder getPlaylist(String playlist_id)
    +
    +
    public GetPlaylistRequest.Builder getPlaylist(String playlist_id)
    Get a playlist.
    Parameters:
    @@ -2861,12 +2606,14 @@

    getPlaylist

    +

  • getPlaylistCoverImage

    -
    public GetPlaylistCoverImageRequest.Builder getPlaylistCoverImage(String playlist_id)
    +
    +
    public GetPlaylistCoverImageRequest.Builder getPlaylistCoverImage(String playlist_id)
    Get the image used to represent a specific playlist.
    Parameters:
    @@ -2880,12 +2627,14 @@

    getPlaylistCoverImage

    +

  • getPlaylistsItems

    -
    public GetPlaylistsItemsRequest.Builder getPlaylistsItems(String playlist_id)
    +
    +
    public GetPlaylistsItemsRequest.Builder getPlaylistsItems(String playlist_id)
    Get a playlist's items.
    Parameters:
    @@ -2899,12 +2648,14 @@

    getPlaylistsItems

    +

  • removeItemsFromPlaylist

    -
    public RemoveItemsFromPlaylistRequest.Builder removeItemsFromPlaylist(String playlist_id, +
    +
    public RemoveItemsFromPlaylistRequest.Builder removeItemsFromPlaylist(String playlist_id, com.google.gson.JsonArray tracks)
    Delete items from a playlist
    @@ -2920,25 +2671,27 @@

    removeItemsFromPlaylist

    +

  • reorderPlaylistsItems

    -
    public ReorderPlaylistsItemsRequest.Builder reorderPlaylistsItems(String playlist_id, +
    +
    public ReorderPlaylistsItemsRequest.Builder reorderPlaylistsItems(String playlist_id, int range_start, int insert_before)
    Reorder an item or a group of items in a playlist.

    -

    - When reordering items, the timestamp indicating when they were added and the user who added them will be kept - untouched. In addition, the users following the playlists won’t be notified about changes in the playlists when the - items are reordered.

    +

    +When reordering items, the timestamp indicating when they were added and the user who added them will be kept +untouched. In addition, the users following the playlists won’t be notified about changes in the playlists when the +items are reordered.

    Parameters:
    playlist_id - The Spotify ID for the playlist.
    range_start - The position of the first item to be reordered.
    insert_before - The position where the items should be inserted. To reorder the items to the end of the - playlist, simply set insert_before to the position after the last item.
    + playlist, simply set insert_before to the position after the last item.
    Returns:
    A ReorderPlaylistsItemsRequest.Builder.
    See Also:
    @@ -2948,13 +2701,15 @@

    reorderPlaylistsItems

    +

  • replacePlaylistsItems

    -
    public ReplacePlaylistsItemsRequest.Builder replacePlaylistsItems(String playlist_id, - String[] uris)
    +
    +
    public ReplacePlaylistsItemsRequest.Builder replacePlaylistsItems(String playlist_id, + String[] uris)
    Replace items in a playlist.
    Parameters:
    @@ -2969,12 +2724,14 @@

    replacePlaylistsItems

    +

  • replacePlaylistsItems

    -
    public ReplacePlaylistsItemsRequest.Builder replacePlaylistsItems(String playlist_id, +
    +
    public ReplacePlaylistsItemsRequest.Builder replacePlaylistsItems(String playlist_id, com.google.gson.JsonArray uris)
    Replace items in a playlist.
    @@ -2990,12 +2747,14 @@

    replacePlaylistsItems

    +

  • uploadCustomPlaylistCoverImage

    -
    public UploadCustomPlaylistCoverImageRequest.Builder uploadCustomPlaylistCoverImage(String playlist_id)
    +
    +
    public UploadCustomPlaylistCoverImageRequest.Builder uploadCustomPlaylistCoverImage(String playlist_id)
    Replace the image used to represent a specific playlist.
    Parameters:
    @@ -3009,28 +2768,32 @@

    uploadCustomPlaylistCoverImage

    +

  • searchItem

    -
    public SearchItemRequest.Builder searchItem(String q, - String type)
    +
    +
    public SearchItemRequest.Builder searchItem(String q, + String type)
    Get Spotify catalog information about artists, albums, episodes, shows, tracks or playlists that match a keyword string.
    Parameters:
    q - The search query's keywords (and optional field filters and operators).
    type - A comma-separated list of item types to search across. Valid types are: album, artist, episode, show, playlist and - track.
    + track.
    Returns:
    A SearchItemRequest.Builder.
    +

  • searchAlbums

    -
    public SearchAlbumsRequest.Builder searchAlbums(String q)
    +
    +
    public SearchAlbumsRequest.Builder searchAlbums(String q)
    Get Spotify catalog information about albums that match a keyword string.
    Parameters:
    @@ -3038,28 +2801,32 @@

    searchAlbums

    Returns:
    A SearchAlbumsRequest.Builder.
    +

  • searchAlbumsSpecial

    -
    public SearchAlbumsSpecialRequest.Builder searchAlbumsSpecial(String q)
    +
    +
    public SearchAlbumsSpecialRequest.Builder searchAlbumsSpecial(String q)
    Get Spotify catalog information about albums that match a keyword string. -

    - This method exists because the searches API returns the undocumented property totalTracks, which is - included by this method's return type.

    +

    +This method exists because the searches API returns the undocumented property totalTracks, which is +included by this method's return type.

    Parameters:
    q - The search query's keywords (and optional field filters and operators).
    Returns:
    A SearchAlbumsSpecialRequest.Builder.
    +

  • searchArtists

    -
    public SearchArtistsRequest.Builder searchArtists(String q)
    +
    +
    public SearchArtistsRequest.Builder searchArtists(String q)
    Get Spotify catalog information about artists that match a keyword string.
    Parameters:
    @@ -3067,12 +2834,14 @@

    searchArtists

    Returns:
    A SearchArtistsRequest.Builder.
    +

  • searchEpisodes

    -
    public SearchEpisodesRequest.Builder searchEpisodes(String q)
    +
    +
    public SearchEpisodesRequest.Builder searchEpisodes(String q)
    Get Spotify catalog information about episodes that match a keyword string.
    Parameters:
    @@ -3080,12 +2849,14 @@

    searchEpisodes

    Returns:
    A SearchEpisodesRequest.Builder.
    +

  • searchPlaylists

    -
    public SearchPlaylistsRequest.Builder searchPlaylists(String q)
    +
    +
    public SearchPlaylistsRequest.Builder searchPlaylists(String q)
    Get Spotify catalog information about playlists that match a keyword string.
    Parameters:
    @@ -3093,12 +2864,14 @@

    searchPlaylists

    Returns:
    A SearchPlaylistsRequest.Builder.
    +

  • searchShows

    -
    public SearchShowsRequest.Builder searchShows(String q)
    +
    +
    public SearchShowsRequest.Builder searchShows(String q)
    Get Spotify catalog information about shows that match a keyword string.
    Parameters:
    @@ -3106,12 +2879,14 @@

    searchShows

    Returns:
    A SearchShowsRequest.Builder.
    +

  • searchTracks

    -
    public SearchTracksRequest.Builder searchTracks(String q)
    +
    +
    public SearchTracksRequest.Builder searchTracks(String q)
    Get Spotify catalog information about tracks that match a keyword string.
    Parameters:
    @@ -3119,12 +2894,14 @@

    searchTracks

    Returns:
    A SearchTracksRequest.Builder.
    +

  • getShow

    -
    public GetShowRequest.Builder getShow(String id)
    +
    +
    public GetShowRequest.Builder getShow(String id)
    Get a show.
    Parameters:
    @@ -3138,31 +2915,14 @@

    getShow

    -
    -
    • -
  • -
    -

    getSeveralShows

    -
    public GetSeveralShowsRequest.Builder getSeveralShows(String... ids)
    -
    Get multiple shows.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs of all shows you're trying to retrieve. Maximum: 50 IDs.
    -
    Returns:
    -
    A GetSeveralShowsRequest.Builder.
    -
    See Also:
    -
    - -
    -
    +

  • getShowEpisodes

    -
    public GetShowsEpisodesRequest.Builder getShowEpisodes(String id)
    +
    +
    public GetShowsEpisodesRequest.Builder getShowEpisodes(String id)
    Get Spotify catalog information about an show’s episodes.
    Parameters:
    @@ -3176,12 +2936,14 @@

    getShowEpisodes

    +

  • getAudioAnalysisForTrack

    -
    public GetAudioAnalysisForTrackRequest.Builder getAudioAnalysisForTrack(String id)
    +
    +
    public GetAudioAnalysisForTrackRequest.Builder getAudioAnalysisForTrack(String id)
    Get a detailed audio analysis for a single track identified by its unique Spotify ID.
    Parameters:
    @@ -3195,12 +2957,14 @@

    getAudioAnalysisForTrack

    +

  • getAudioFeaturesForTrack

    -
    public GetAudioFeaturesForTrackRequest.Builder getAudioFeaturesForTrack(String id)
    +
    +
    public GetAudioFeaturesForTrackRequest.Builder getAudioFeaturesForTrack(String id)
    Get audio features for a track based on its Spotify ID.
    Parameters:
    @@ -3214,12 +2978,14 @@

    getAudioFeaturesForTrack

    +

  • getAudioFeaturesForSeveralTracks

    -
    public GetAudioFeaturesForSeveralTracksRequest.Builder getAudioFeaturesForSeveralTracks(String... ids)
    +
    +
    public GetAudioFeaturesForSeveralTracksRequest.Builder getAudioFeaturesForSeveralTracks(String... ids)
    Get audio features for multiple tracks based on their Spotify IDs.
    Parameters:
    @@ -3233,31 +2999,14 @@

    getAudioFeaturesForSeveralTracks

    -
    -
    • -
  • -
    -

    getSeveralTracks

    -
    public GetSeveralTracksRequest.Builder getSeveralTracks(String... ids)
    -
    Get multiple tracks.
    -
    -
    Parameters:
    -
    ids - The Spotify IDs of all tracks you're trying to retrieve. Maximum: 50 IDs.
    -
    Returns:
    -
    A GetSeveralTracksRequest.Builder.
    -
    See Also:
    -
    - -
    -
    +

  • getTrack

    -
    public GetTrackRequest.Builder getTrack(String id)
    +
    +
    public GetTrackRequest.Builder getTrack(String id)
    Get a track.
    Parameters:
    @@ -3271,36 +3020,20 @@

    getTrack

    +

  • getCurrentUsersProfile

    +
    public GetCurrentUsersProfileRequest.Builder getCurrentUsersProfile()
    Get detailed profile information about the current user (including the current user’s username).
    Returns:
    A GetCurrentUsersProfileRequest.Builder.
    -
    -
    • -
  • -
    -

    getUsersProfile

    -
    public GetUsersProfileRequest.Builder getUsersProfile(String user_id)
    -
    Get public profile information about a Spotify user.
    -
    -
    Parameters:
    -
    user_id - The Spotify ID of the user.
    -
    Returns:
    -
    A GetUsersProfileRequest.Builder.
    -
    See Also:
    -
    - -
    -
    +
    • @@ -3309,12 +3042,11 @@

    getUsersProfile

    - -