Spotify.NET/docs/web/playlists/index.html
2020-11-16 09:14:50 +00:00

32 lines
35 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width">
<meta name="generator" content="Docusaurus v2.0.0-alpha.56">
<title data-react-helmet="true">Playlists | SpotifyAPI-NET</title><meta data-react-helmet="true" name="docsearch:version" content="5.1.1"><meta data-react-helmet="true" name="twitter:card" content="summary_large_image"><meta data-react-helmet="true" property="og:title" content="Playlists | SpotifyAPI-NET"><meta data-react-helmet="true" name="description" content="GetUserPlaylists"><meta data-react-helmet="true" property="og:description" content="GetUserPlaylists"><meta data-react-helmet="true" property="og:url" content="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/web/playlists"><link data-react-helmet="true" rel="shortcut icon" href="/SpotifyAPI-NET/img/favicon.ico"><link data-react-helmet="true" rel="canonical" href="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/web/playlists"><link rel="stylesheet" href="/SpotifyAPI-NET/styles.8a053330.css">
<link rel="preload" href="/SpotifyAPI-NET/styles.20e5fb07.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/runtime~main.2ac8fadd.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/main.420c9379.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/1.d763968b.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/2.c001a4a7.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/3.c31fd0fb.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/1be78505.6d7d8bd2.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/3d0d8a2f.44e5d4a3.js" as="script">
<link rel="preload" href="/SpotifyAPI-NET/e06aacec.ee3b1766.js" as="script">
</head>
<body>
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();null!==n?t(n):e.matches&&t("dark")}()</script><div id="__docusaurus">
<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a class="navbar__brand" href="/SpotifyAPI-NET/"><img class="navbar__logo" src="/SpotifyAPI-NET/img/logo.svg" alt="SpotifyAPI-NET"><strong class="navbar__title">SpotifyAPI-NET</strong></a><div class="navbar__item dropdown dropdown--hoverable dropdown--left"><a activeclassname="navbar__link--active" class="navbar__item navbar__link">Docs</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/SpotifyAPI-NET/docs/next/introduction">Latest/Next</a></li><li><a class="dropdown__link" href="/SpotifyAPI-NET/docs/home">5.1.1</a></li></ul></div><a class="navbar__item navbar__link" href="/SpotifyAPI-NET/news">News</a></div><div class="navbar__items navbar__items--right"><a href="https://github.com/JohnnyCrazy/SpotifyAPI-NET" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub</a><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a class="navbar__brand" href="/SpotifyAPI-NET/"><img class="navbar__logo" src="/SpotifyAPI-NET/img/logo.svg" alt="SpotifyAPI-NET"><strong class="navbar__title">SpotifyAPI-NET</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a activeclassname="navbar__link--active" class="menu__link menu__link--sublist">Docs</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/SpotifyAPI-NET/docs/next/introduction">Latest/Next</a></li><li class="menu__list-item"><a class="menu__link" href="/SpotifyAPI-NET/docs/home">5.1.1</a></li></ul></li><li class="menu__list-item"><a class="menu__link" href="/SpotifyAPI-NET/news">News</a></li><li class="menu__list-item"><a href="https://github.com/JohnnyCrazy/SpotifyAPI-NET" target="_blank" rel="noopener noreferrer" class="menu__link">GitHub</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive menu_w2sC"><button aria-label="Open Menu" aria-haspopup="true" class="button button--secondary button--sm menu__button" type="button"><svg aria-label="Menu" class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">SpotifyAPI-NET</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/home">Home</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">SpotifyAPI-NET.Web</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/getting_started">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/albums">Albums</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/artists">Artists</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/browse">Browse</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/follow">Follow</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/library">Library</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/personalization">Personalization</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/player">Player</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active active" tabindex="0" href="/SpotifyAPI-NET/docs/web/playlists">Playlists</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/profiles">Profiles</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/proxy">Proxy Settings</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/search">Search</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/tracks">Tracks</a></li><li class="menu__list-item"><a class="menu__link" tabindex="0" href="/SpotifyAPI-NET/docs/web/utilities">Utilities</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">SpotifyAPI-NET.Auth</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/auth/getting_started">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/auth/implicit_grant">Implicit Grant</a></li><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/auth/authorization_code">Authorization Code</a></li><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/auth/client_credentials">Client Credentials</a></li><li class="menu__list-item"><a class="menu__link" tabindex="-1" href="/SpotifyAPI-NET/docs/auth/token_swap">Token Swap</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="container padding-vert--lg docItemWrapper_1cc7"><div class="row"><div class="col docItemCol_2GOA"><div class="docItemContainer_2cwg"><article><div><span class="badge badge--secondary">Version: 5.1.1</span></div><header><h1 class="docTitle_1vWb">Playlists</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="getuserplaylists"></a>GetUserPlaylists<a aria-hidden="true" tabindex="-1" class="hash-link" href="#getuserplaylists" title="Direct link to heading">#</a></h2><blockquote><p>Get a list of the playlists owned or followed by a Spotify user.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>[limit]</td><td>The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.</td><td><code>20</code></td></tr><tr><td>[offset]</td><td>The index of the first playlist to return. Default: 0 (the first object)</td><td><code>0</code></td></tr></tbody></table><p>Returns a <a href="https://developer.spotify.com/web-api/object-model/#playlist-object-simplified" target="_blank" rel="noopener noreferrer">SimplePlaylist</a> wrapped inside a <a href="https://developer.spotify.com/web-api/object-model/#paging-object" target="_blank" rel="noopener noreferrer">Paging Object</a></p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">Paging&lt;SimplePlaylist&gt; userPlaylists = _spotify.GetUserPlaylists(&quot;1122095781&quot;);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">userPlaylists.Items.ForEach(playlist =&gt; playlist.Owner.DisplayName) //Who is the owner of the playlist?</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="getplaylist"></a>GetPlaylist<a aria-hidden="true" tabindex="-1" class="hash-link" href="#getplaylist" title="Direct link to heading">#</a></h2><blockquote><p>Get a playlist owned by a Spotify user.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>[fields]</td><td>Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.</td><td><code>&quot;description,uri&quot;</code></td></tr><tr><td>[market]</td><td>An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.</td><td>&quot;DE&quot;</td></tr></tbody></table><p>Returns a <a href="https://developer.spotify.com/web-api/object-model/#track-object-full" target="_blank" rel="noopener noreferrer">FullTrack</a></p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">FullPlaylist playlist = _spotify.GetPlaylist(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">playlist.Tracks.Items.ForEach(track =&gt; Console.WriteLine(track.Track.Name));</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="getplaylisttracks"></a>GetPlaylistTracks<a aria-hidden="true" tabindex="-1" class="hash-link" href="#getplaylisttracks" title="Direct link to heading">#</a></h2><blockquote><p>Get full details of the tracks of a playlist owned by a Spotify user.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>[fields]</td><td>Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.</td><td><code>&quot;description,uri&quot;</code></td></tr><tr><td>[limit]</td><td>The maximum number of tracks to return. Default: 100. Minimum: 1. Maximum: 100.</td><td><code>100</code></td></tr><tr><td>[offset]</td><td>The index of the first object to return. Default: 0 (i.e., the first object)</td><td><code>0</code></td></tr><tr><td>[market]</td><td>An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.</td><td><code>DE</code></td></tr></tbody></table><p>Returns a <a href="https://developer.spotify.com/web-api/object-model/#playlist-object-simplified" target="_blank" rel="noopener noreferrer">PlaylistTrack</a> wrapped inside a <a href="https://developer.spotify.com/web-api/object-model/#paging-object" target="_blank" rel="noopener noreferrer">Paging Object</a></p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">Paging&lt;PlaylistTrack&gt; playlist = _spotify.GetPlaylistTracks(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">playlist.Items.ForEach(track =&gt; Console.WriteLine(track.Track.Name));</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="createplaylist"></a>CreatePlaylist<a aria-hidden="true" tabindex="-1" class="hash-link" href="#createplaylist" title="Direct link to heading">#</a></h2><blockquote><p>Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.)</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistName</td><td>The name for the new playlist, for example &quot;Your Coolest Playlist&quot;. This name does not need to be unique.</td><td><code>&quot;This is my new Playlist&quot;</code></td></tr><tr><td>[isPublic]</td><td>default true. If true the playlist will be public, if false it will be private. To be able to create private playlists, the user must have granted the playlist-modify-private scope.</td><td><code>true</code></td></tr></tbody></table><p>Returns a <a href="https://developer.spotify.com/web-api/object-model/#playlist-object-full" target="_blank" rel="noopener noreferrer">FullPlaylist</a></p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">FullPlaylist playlist = _spotify.CreatePlaylist(&quot;1122095781&quot;, &quot;This is my new Playlist&quot;);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">if(!playlist.HasError())</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> Console.WriteLine(&quot;Playlist-URI: &quot; + playlist.Uri);</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="updateplaylist"></a>UpdatePlaylist<a aria-hidden="true" tabindex="-1" class="hash-link" href="#updateplaylist" title="Direct link to heading">#</a></h2><blockquote><p>Change a playlists name and public/private state. (The user must, of course, own the playlist.)</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>[newName]</td><td>The new name for the playlist, for example &quot;My New Playlist Title&quot;.</td><td><code>&quot;New Playlistname&quot;</code></td></tr><tr><td>[newPublic]</td><td>If true the playlist will be public, if false it will be private.</td><td>EXAMPLE</td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.UpdatePlaylist(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, &quot;New Name&quot;, true);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">if(!response.HasError())</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> Console.WriteLine(&quot;success&quot;);</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="replaceplaylisttracks"></a>ReplacePlaylistTracks<a aria-hidden="true" tabindex="-1" class="hash-link" href="#replaceplaylisttracks" title="Direct link to heading">#</a></h2><blockquote><p>Replace all the tracks in a playlist, overwriting its existing tracks. This powerful request can be useful for replacing tracks, re-ordering existing tracks, or clearing the playlist.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>uris</td><td>A list of Spotify track URIs to set. A maximum of 100 tracks can be set in one request.</td><td><code>new List&lt;string&gt; { &quot;1ri6UZpjPLmTCswIXZ6Uq1&quot; }</code></td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.ReplacePlaylistTracks(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new List&lt;string&gt; { &quot;1ri6UZpjPLmTCswIXZ6Uq1&quot; });</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">if(!response.HasError())</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> Console.WriteLine(&quot;success&quot;);</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="removeplaylisttracks"></a>RemovePlaylistTracks<a aria-hidden="true" tabindex="-1" class="hash-link" href="#removeplaylisttracks" title="Direct link to heading">#</a></h2><blockquote><p>Remove one or more tracks from a users playlist.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>uris</td><td>array of objects containing Spotify URI strings (and their position in the playlist). A maximum of 100 objects can be sent at once.</td><td><code>(example below)</code></td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">//Remove multiple tracks</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse playlist = _spotify.RemovePlaylistTracks(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new List&lt;DeleteTrackUri&gt;()</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">{</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> new DeleteTrackUri(&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;),</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> new DeleteTrackUri(&quot;47xtGU3vht7mXLHqnbaau5&quot;)</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">});</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">//Remove multiple tracks at their specified positions</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse playlist = _spotify.RemovePlaylistTracks(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new List&lt;DeleteTrackUri&gt;()</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">{</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> new DeleteTrackUri(&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;, 2),</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> new DeleteTrackUri(&quot;47xtGU3vht7mXLHqnbaau5&quot;, 0, 50)</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">});</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="removeplaylisttrack"></a>RemovePlaylistTrack<a aria-hidden="true" tabindex="-1" class="hash-link" href="#removeplaylisttrack" title="Direct link to heading">#</a></h2><blockquote><p>Remove one or more tracks from a users playlist.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>uri</td><td>Spotify URI</td><td><code>new DeleteTrackUri(&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;)</code></td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">//Remove all tracks with the specified URI</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.RemovePlaylistTrack(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new DeleteTrackUri(&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;));</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">//Remove all tracks with the specified URI and the specified positions</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.RemovePlaylistTrack(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new DeleteTrackUri(&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;, 0, 10, 20));</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="addplaylisttracks"></a>AddPlaylistTracks<a aria-hidden="true" tabindex="-1" class="hash-link" href="#addplaylisttracks" title="Direct link to heading">#</a></h2><blockquote><p>Add one or more tracks to a users playlist.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>uris</td><td>A list of Spotify track URIs to add</td><td><code>new List&lt;string&gt; { &quot;1ri6UZpjPLmTCswIXZ6Uq1&quot; }</code></td></tr><tr><td>[position]</td><td>The position to insert the tracks, a zero-based index</td><td><code>10</code></td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.AddPlaylistTracks(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, new List&lt;string&gt; { &quot;1ri6UZpjPLmTCswIXZ6Uq1&quot; });</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">if(!response.HasError())</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> Console.WriteLine(&quot;Success&quot;);</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="addplaylisttrack"></a>AddPlaylistTrack<a aria-hidden="true" tabindex="-1" class="hash-link" href="#addplaylisttrack" title="Direct link to heading">#</a></h2><blockquote><p>Add one or more tracks to a users playlist.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>uri</td><td>A Spotify Track URI</td><td><code>&quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;</code></td></tr><tr><td>position</td><td>The position to insert the tracks, a zero-based index</td><td><code>10</code></td></tr></tbody></table><p>Returns a <code>ErrorResponse</code> which just contains a possible error. (<code>response.HasError()</code> and <code>response.Error</code>)</p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">ErrorResponse response = _spotify.AddPlaylistTrack(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, &quot;1ri6UZpjPLmTCswIXZ6Uq1&quot;);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">if(!response.HasError())</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain"> Console.WriteLine(&quot;Success&quot;);</span></div></div></div></div></div><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor enhancedAnchor_ZqCz" id="reorderplaylist"></a>ReorderPlaylist<a aria-hidden="true" tabindex="-1" class="hash-link" href="#reorderplaylist" title="Direct link to heading">#</a></h2><blockquote><p>Reorder a track or a group of tracks in a playlist.
More Info: <a href="https://developer.spotify.com/web-api/reorder-playlists-tracks/" target="_blank" rel="noopener noreferrer">Reorder-Playlist</a></p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>userId</td><td>The user&#x27;s Spotify user ID.</td><td><code>&quot;1122095781&quot;</code></td></tr><tr><td>playlistId</td><td>The Spotify ID for the playlist.</td><td><code>&quot;1TtEejT1y4D1WmcOnLfha2&quot;</code></td></tr><tr><td>rangeStart</td><td>The position of the first track to be reordered.</td><td><code>2</code></td></tr><tr><td>insertBefore</td><td>The position where the tracks should be inserted.</td><td><code>0</code></td></tr><tr><td>[rangeLength]</td><td>The amount of tracks to be reordered. Defaults to 1 if not set.</td><td><code>2</code></td></tr><tr><td>[snapshotId]</td><td>The playlist&#x27;s snapshot ID against which you want to make the changes.</td><td>``</td></tr></tbody></table><p>Returns a <code>Snapshot</code>-Object which contains the property <code>String SnapshotId</code></p><p><strong>Usage</strong></p><div class="mdxCodeBlock_iHAB"><div class="codeBlockContent_32p_"><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button><div tabindex="0" class="prism-code language-csharp codeBlock_19pQ"><div class="codeBlockLines_2n9r" style="color:#bfc7d5;background-color:#292d3e"><div class="token-line" style="color:#bfc7d5"><span class="token plain">Snapshot snapshot = _spotify.ReorderPlaylist(&quot;1122095781&quot;, &quot;1TtEejT1y4D1WmcOnLfha2&quot;, 2, 0, 2);</span></div><div class="token-line" style="color:#bfc7d5"><span class="token plain">Console.WriteLine(&quot;New SnapshotId: &quot; + snapshot.SnapshotId);</span></div></div></div></div></div><hr></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/JohnnyCrazy/SpotifyAPI-NET/edit/master/SpotifyAPI.Docs/versioned_docs/version-5.1.1/web/playlists.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2020-11-16T09:13:25.000Z" class="docLastUpdatedAt_1sqk">11/16/2020</time> by <strong>dependabot[bot]</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/SpotifyAPI-NET/docs/web/player"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">« Player</div></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/SpotifyAPI-NET/docs/web/profiles"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Profiles »</div></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#getuserplaylists" class="table-of-contents__link">GetUserPlaylists</a></li><li><a href="#getplaylist" class="table-of-contents__link">GetPlaylist</a></li><li><a href="#getplaylisttracks" class="table-of-contents__link">GetPlaylistTracks</a></li><li><a href="#createplaylist" class="table-of-contents__link">CreatePlaylist</a></li><li><a href="#updateplaylist" class="table-of-contents__link">UpdatePlaylist</a></li><li><a href="#replaceplaylisttracks" class="table-of-contents__link">ReplacePlaylistTracks</a></li><li><a href="#removeplaylisttracks" class="table-of-contents__link">RemovePlaylistTracks</a></li><li><a href="#removeplaylisttrack" class="table-of-contents__link">RemovePlaylistTrack</a></li><li><a href="#addplaylisttracks" class="table-of-contents__link">AddPlaylistTracks</a></li><li><a href="#addplaylisttrack" class="table-of-contents__link">AddPlaylistTrack</a></li><li><a href="#reorderplaylist" class="table-of-contents__link">ReorderPlaylist</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="text--center"><div>Copyright © 2020 Jonas Dellinger. Built with Docusaurus.</div></div></div></footer></div>
<script src="/SpotifyAPI-NET/styles.20e5fb07.js"></script>
<script src="/SpotifyAPI-NET/runtime~main.2ac8fadd.js"></script>
<script src="/SpotifyAPI-NET/main.420c9379.js"></script>
<script src="/SpotifyAPI-NET/1.d763968b.js"></script>
<script src="/SpotifyAPI-NET/2.c001a4a7.js"></script>
<script src="/SpotifyAPI-NET/3.c31fd0fb.js"></script>
<script src="/SpotifyAPI-NET/1be78505.6d7d8bd2.js"></script>
<script src="/SpotifyAPI-NET/3d0d8a2f.44e5d4a3.js"></script>
<script src="/SpotifyAPI-NET/e06aacec.ee3b1766.js"></script>
</body>
</html>