mirror of
https://github.com/Sarsoo/Spotify.NET.git
synced 2024-12-29 17:16:26 +00:00
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
# Personalization
|
||
|
||
## GetUsersTopTracks
|
||
|
||
> Get the current user’s top tracks based on calculated affinity.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|[timeRange]| Over what time frame the affinities are compute. | `TimeRangeType.MediumTerm`
|
||
|[limit]| The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. | `20`
|
||
|[offset]| The index of the first entity to return. Default: 0 (i.e., the first track). Use with limit to get the next set of entities. | `0`
|
||
|
||
Returns a [FullTrack](https://developer.spotify.com/web-api/object-model/#track-object-full) wrapped inside a [Paging-object](https://developer.spotify.com/web-api/object-model/#paging-object)
|
||
|
||
**Usage**
|
||
|
||
```
|
||
Paging<FullTrack> tracks = _spotify.GetUsersTopTracks();
|
||
tracks.Items.ForEach(item => Console.WriteLine(item.Name)); //Display all fetched Track-Names (max 20)
|
||
Console.WriteLine(tracks.Total.ToString()) //Display total album track count
|
||
```
|
||
|
||
---
|
||
## GetUsersTopArtists
|
||
> Get the current user’s top artists based on calculated affinity.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|[timeRange]| Over what time frame the affinities are compute. | `TimeRangeType.MediumTerm`
|
||
|[limit]| The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. | `20`
|
||
|[offset]| The index of the first entity to return. Default: 0 (i.e., the first track). Use with limit to get the next set of entities. | `0`
|
||
|
||
Returns a [FullArtist](https://developer.spotify.com/web-api/object-model/#artist-object-full) wrapped inside a [Paging-object](https://developer.spotify.com/web-api/object-model/#paging-object)
|
||
|
||
**Usage**
|
||
```
|
||
Paging<FullArtist> artists = _spotify.GetUsersTopArtists();
|
||
artists.Items.ForEach(item => Console.WriteLine(item.Name)); //Display all fetched Artist-Names (max 20)
|
||
```
|
||
|
||
---
|
||
## GetUsersRecentlyPlayedTracks
|
||
> Get tracks from the current user’s recent play history.
|
||
|
||
**Parameters**
|
||
|
||
|Name|Description|Example|
|
||
|--------------|-------------------------|-------------------------|
|
||
|[limit]| The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. | `20`
|
||
|[after]| Returns all items after (but not including) this cursor position. | `DateTime.Now.AddDays(-1)`
|
||
|[before]| Returns all items before (but not including) this cursor position. | `DateTime.Now.AddDays(-1)`
|
||
|
||
Returns a `PlayHistory` wrapped inside a [CursorPaging-object](https://developer.spotify.com/web-api/object-model/#cursor-based-paging-object)
|
||
|
||
**Usage**
|
||
```
|
||
CursorPaging<PlayHistory> histories = _spotify.GetUsersRecentlyPlayedTracks();
|
||
histories.Items.ForEach(item => Console.WriteLine(item.Track.Name));
|
||
```
|
||
|
||
---
|