Refresh methods according to the official documentation

[dieser-niko]

This is already overdue, so if anyone wants to point out if I missed a function, let me know.

Closes #1211
Closes #1210

[dieser-niko]

This is a list of all endpoints and their respective spotipy methods.
Some of them require attention in this PR, and these are marked as such.

A global issue was also identified: the exclusion of episodes.
More often than not, only tracks can be submitted.

Also, some endpoints only fetch tracks instead of tracks and episodes.
Spotify claims that the parameter additional_types is going to be deprecated in the future,
in which case both types will be returned. Currently, the default value for this parameter is track.
This was apparently done so that older clients that might not be able to handle episodes would not be affected
and would have time to prepare for the change.

There are some missing methods too. These are:

• Get User's Saved Audiobooks
• Save Audiobooks for Current User
• Remove User's Saved Audiobooks
• Check User's Saved Audiobooks
• Get a Chapter
• Get Several Chapters

Albums

Details

Get Album

• album

Get Several Albums

• albums

Get Album Tracks

• album_tracks

Get User's Saved Albums

• current_user_saved_albums

Save Albums for Current User

• current_user_saved_albums_add

Remove Users' Saved Albums

• current_user_saved_albums_delete

Check User's Saved Albums

• current_user_saved_albums_contains

Get New Releases

• new_releases

Artists

Details

Get Artist

• artist

Get Several Artists

• artists

Get Artist's Albums

• artist_albums

Get Artist's Top Tracks

• artist_top_tracks

Get Artist's Related Artists (deprecated)

• artist_related_artists (deprecated)

Audiobooks

Details

Get an Audiobook

• get_audiobook

Get Several Audiobooks

• get_audiobooks

Get Audiobook Chapters

• get_audiobook_chapters

Get User's Saved Audiobooks

Save Audiobooks for Current User

Remove User's Saved Audiobooks

Check User's Saved Audiobooks

Categories

Details

Get Several Browse Categories

• categories

Get Single Browse Category

• category

Chapters

Details

Get a Chapter

Get Several Chapters

Episodes

Details

Get Episode

• episode

Get Several Episodes

• episodes

Get User's Saved Episodes

• current_user_saved_episodes

Save Episodes for Current User

• current_user_saved_episodes_add

Remove User's Saved Episodes

• current_user_saved_episodes_delete

Check User's Saved Episodes

• current_user_saved_episodes_contains

Genres

Details

Get Available Genre Seeds (deprecated)

• recommendation_genre_seeds (deprecated)

Markets

Details

Get Available Markets

• available_markets

Player

Details

Get Playback State

• current_playback

Transfer Playback

• transfer_playback

Get Available Devices

• devices

Get Currently Playing Track

• current_user_playing_track (TODO?)
• currently_playing (TODO?)

Start/Resume Playback

• start_playback

Pause Playback

• pause_playback

Skip To Next

• next_track

Skip To Previous

• previous_track

Seek To Position

• seek_track

Set Repeat Mode

• repeat

Set Playback Volume

• volume

Toggle Playback Shuffle

• shuffle

Get Recently Played Tracks

• current_user_recently_played

Get the User's Queue

• queue

Add Item to Playback Queue

• add_to_queue

Playlists

Details

Get Playlist

• playlist
• user_playlist (deprecated)

Change Playlist Details

• user_playlist_change_details (deprecated)

Get Playlist Items

• playlist_tracks (deprecated)
• playlist_items
• user_playlist_tracks (deprecated)

Update Playlist Items

• playlist_replace_items (TODO)
• playlist_reorder_items (TODO)

Add Items to Playlist

• user_playlist_add_tracks (deprecated)
• user_playlist_add_episodes (deprecated)

Remove Playlist Items

• playlist_remove_all_occurrences_of_items (TODO, but correct usage)
• playlist_remove_specific_occurrences_of_items (TODO, deprecated)

Get Current User's Playlists

• current_user_playlists

Get User's Playlists

• user_playlists

Create Playlist

• user_playlist_create

Get Featured Playlists (deprecated)

• featured_playlists (deprecated)

Get Category's Playlists (deprecated)

• category_playlists (deprecated)

Get Playlist Cover Image

• playlist_cover_image

Add Custom Playlist Cover Image

• playlist_upload_cover_image

Search

Details

Search for Item

• search
• search_markets

Shows

Details

Get Show

• show

Get Several Shows

• shows

Get Show Episodes

• show_episodes

Get User's Saved Shows

• current_user_saved_shows

Save Shows for Current User

• current_user_saved_shows_add

Remove User's Saved Shows

• current_user_saved_shows_delete

Check User's Saved Shows

• current_user_saved_shows_contains

Tracks

Details

Get Track

• track

Get Several Tracks

• tracks

Get User's Saved Tracks

• current_user_saved_tracks

Save Tracks for Current User

• current_user_saved_tracks_add (TODO, changed to body)

Remove User's Saved Tracks

• current_user_saved_tracks_delete

Check User's Saved Tracks

• current_user_saved_tracks_contains

Get Several Tracks' Audio Features (deprecated)

• audio_features (deprecated)

Get Track's Audio Features (deprecated) (also not in use)

Get Track's Audio Analysis (deprecated)

• audio_analysis (deprecated)

Get Recommendations (deprecated)

• recommendations (deprecated)

Users

Details

Get Current User's Profile

• me
• current_user (alias)

Get User's Top Items

• current_user_top_artists
• current_user_top_tracks

Get User's Profile

• user

Follow Playlist

• current_user_follow_playlist

Unfollow Playlist

• user_playlist_unfollow (deprecated)
• current_user_unfollow_playlist

Get Followed Artists

• current_user_followed_artists

Follow Artists or Users

• user_follow_artists
• user_follow_users

Unfollow Artists or Users

• user_unfollow_artists
• user_unfollow_users

Check If User Follows Artists or Users

• current_user_following_artists
• current_user_following_users

Check if Current User Follows Playlist

• playlist_is_following