mirror of
https://github.com/Sarsoo/Spotify.NET.git
synced 2024-12-25 07:26:28 +00:00
209 lines
6.1 KiB
Markdown
209 lines
6.1 KiB
Markdown
---
|
||
id: library
|
||
title: Library
|
||
sidebar_label: Library
|
||
---
|
||
|
||
## SaveTracks
|
||
|
||
> Save one or more tracks to the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs | `new List<String> { "3Hvu1pq89D4R0lyPBoujSv" }`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.SaveTracks(new List<string> { "3Hvu1pq89D4R0lyPBoujSv" });
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## SaveTrack
|
||
|
||
> Save one track to the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|id| A Spotify ID | `"3Hvu1pq89D4R0lyPBoujSv"`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.SaveTrack("3Hvu1pq89D4R0lyPBoujSv");
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## GetSavedTracks
|
||
|
||
> Get a list of the songs saved in the current Spotify user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|[limit]| The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50. | `20`
|
||
|[offset]| The index of the first object to return. Default: 0 (i.e., the first object) | `0`
|
||
|[market]| An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. | `DE`
|
||
|
||
Returns a `Paging<SavedTrack>**, **SavedTrack` contains 2 properties, `DateTime AddedAt` and `FullTrack Track`
|
||
|
||
**Usage**
|
||
```csharp
|
||
Paging<SavedTrack> savedTracks = _spotify.GetSavedTracks();
|
||
savedTracks.Items.ForEach(track => Console.WriteLine(track.Track.Name));
|
||
```
|
||
|
||
---
|
||
## RemoveSavedTracks
|
||
|
||
> Remove one or more tracks from the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs. | `new List<String> { "3Hvu1pq89D4R0lyPBoujSv" }`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.RemoveSavedTracks(new List<string> { "3Hvu1pq89D4R0lyPBoujSv" });
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## CheckSavedTracks
|
||
|
||
> Check if one or more tracks is already saved in the current Spotify user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs. | `new List<String> { "3Hvu1pq89D4R0lyPBoujSv" }`
|
||
|
||
Returns a `ListResponse<bool>` which contains a property, `List<bool> List`
|
||
|
||
**Usage**
|
||
```csharp
|
||
ListResponse<bool> tracksSaved = _spotify.CheckSavedTracks(new List<String> { "3Hvu1pq89D4R0lyPBoujSv" });
|
||
if(tracksSaved.List[0])
|
||
Console.WriteLine("The track is in your library!");
|
||
```
|
||
|
||
---
|
||
## SaveAlbums
|
||
|
||
> Save one or more albums to the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs | `new List<String> { "1cq06d0kTUnFmJHixz1RaF" }`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.SaveAlbums(new List<string> { "1cq06d0kTUnFmJHixz1RaF" });
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## SaveAlbum
|
||
|
||
> Save one album to the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|id| A Spotify ID | `"1cq06d0kTUnFmJHixz1RaF"`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.SaveAlbum("1cq06d0kTUnFmJHixz1RaF");
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## GetSavedAlbums
|
||
|
||
> Get a list of the albums saved in the current Spotify user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|[limit]| The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50. | `20`
|
||
|[offset]| The index of the first object to return. Default: 0 (i.e., the first object) | `0`
|
||
|[market]| An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. | `DE`
|
||
|
||
Returns a `Paging<SavedAlbum>`, **SavedAlbum** contains 2 properties, `DateTime AddedAt` and `FullAlbum Album`
|
||
|
||
**Usage**
|
||
```csharp
|
||
Paging<SavedAlbum> savedAlbums = _spotify.GetSavedAlbums();
|
||
savedAlbums.Items.ForEach(album => Console.WriteLine(album.Album.Name));
|
||
```
|
||
|
||
---
|
||
## RemoveSavedAlbums
|
||
|
||
> Remove one or more albums from the current user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs. | `new List<String> { "1cq06d0kTUnFmJHixz1RaF" }`
|
||
|
||
Returns a `ErrorResponse` which just contains a possible error. (`response.HasError()` and `response.Error`)
|
||
|
||
**Usage**
|
||
```csharp
|
||
ErrorResponse response = _spotify.RemoveSavedAlbums(new List<string> { "1cq06d0kTUnFmJHixz1RaF" });
|
||
if(!response.HasError())
|
||
Console.WriteLine("success");
|
||
```
|
||
|
||
---
|
||
## CheckSavedAlbums
|
||
|
||
> Check if one or more albums is already saved in the current Spotify user’s “Your Music” library.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|ids| A list of the Spotify IDs. | `new List<String> { "1cq06d0kTUnFmJHixz1RaF" }`
|
||
|
||
Returns a `ListResponse<bool>` which contains a property, `List<bool> List`
|
||
|
||
**Usage**
|
||
```csharp
|
||
ListResponse<bool> albumsSaved = _spotify.CheckSavedAlbums(new List<String> { "1cq06d0kTUnFmJHixz1RaF" });
|
||
if(albumsSaved.List[0])
|
||
Console.WriteLine("The album is in your library!");
|
||
```
|
||
|
||
---
|