**Стабильная версия библиотеки**
**Переломные изменения**
- Поле `error` класса `Artist` теперь называется `reason`.
- Метод `users_playlists` класса `Client` теперь возвращает один объект плейлиста, когда был передан один `kind`. При передаче списка в `kind` вернётся список плейлистов ([318](https://github.com/MarshalX/yandex-music-api/issues/318)).
- Поле `labels` класса `Album` теперь может содержать список из строк, а не только список объектов класса `Label`.
**Крупные изменения**
- Добавлены примеры в папку `examples`.
- **Добавлена поддержка рекомендаций для плейлистов ([324](https://github.com/MarshalX/yandex-music-api/issues/324))**:
- Добавлен класс `PlaylistRecommendations`.
- Добавлен метод клиента для получения рекомендаций(`users_playlists_recommendations`).
- Добавлен метод `get_recommendations` классу `Playlist` для
- **Добавлено получение чартов ([294](https://github.com/MarshalX/yandex-music-api/issues/294))**:
- Добавлены новые классы: `ChartInfo`, `ChartInfoMenu`,`ChartInfoMenuItem`.
- Добавлен метод клиента для получения чарта (`chart`).
- **Добавлена поддержка тегов/подборок ([192](https://github.com/MarshalX/yandex-music-api/issues/192))**:
- Добавлены новые классы: `TagResult`, `Tag`.
- Добавлен новый метод клиента для получения тегов (`tags`).
- **Добавлено присоединение к коллективному плейлисту ([317](https://github.com/MarshalX/yandex-music-api/issues/317))**:
- Добавлен новый метод клиента для присоединения(`playlists_collective_join`).
- **Добавлена поддержка очередей прослушивания ([246](https://github.com/MarshalX/yandex-music-api/issues/246))**:
- Добавлены новые классы: `Context`, `Queue`, `QueueItem`.
- Добавлены новые методы в `Client`: `queues_list`, `queue`,`queue_update_position`, `queue_create`.
- Добавлены поля `track_id` и `from_` в класс `TrackId`.
- Добавлена возможность смены языка у клиента для ответов от API.
- Добавлена десериализация любого объекта в `JSON` пригодного для отправки в запросе на Яндекс API.
- **Добавлены следующие методы для `Client`**:
- `new_releases` – получение полного списка всех новых релизов.
- `new_playlists` – получение полного списка всех новый плейлистов.
- `podcasts` – получение подкаста с лендинга.
- **Добавлены новые сокращения в модели**:
- `download_cover_white`, `download_cover_uri` в `MixLink`.
- `download_image` в `Promotion`.
- `artists_name` в `Album` и `Track`.
- `fetch_track`, `track_full_id` в `TrackId`.
- `fetch_tracks` в `TracksList`.
- `insert_track`, `delete_tracks`, `delete` в `Playlist`.
- `playlist_id`, `fetch_playlist` в `PlaylistId`.
- `get_current_track` в `Queue`.
- `fetch_queue` в `QueueItem`.
- `next_page`, `get_page`, `prev_page` в `Search`.
- и другие...
- Добавлена поддержка новых типов поиска: подкасты, выпуски, пользователи.
- Добавлен callback для обработки новых полей.
- Добавлена информацию по поводу запуска потока по треку, плейлисту и др.
- Добавлена десериализация `decomposed` у `Artist` ([10](https://github.com/MarshalX/yandex-music-api/issues/10)).
- Добавлен `__len__` для `TracksList` ([380](https://github.com/MarshalX/yandex-music-api/issues/380)).
- Добавлены `__iter__`, `__len__` и `__getitem__` для классов представляющих список каких-либо объектов.
- Добавлено сокращение `fetch_tracks` классу `Playlist` для получения треков плейлиста.
- Добавлен метод `get_url` классу `Icon` для получения прямой ссылки на изображение.
- Класс `User` расширен для поддержки поля `user_info` из `Track`(поля `full_name`, `display_name`).
- **Добавлены новые классы по отчётам с Telegram бота ([306](https://github.com/MarshalX/yandex-music-api/issues/306), [#398](https://github.com/MarshalX/yandex-music-api/issues/398))**:
- `LandingList`.
- `RenewableRemainder`.
- `Alert`.
- `AlertButton`.
- `StationData`.
- `Brand`.
- `Contest`.
- `OpenGraphData`.
- `NonAutoRenewable`.
- `Operator`.
- `Deactivation`.
- `PoetryLoverMatch`.
- `Deprecation`.
- **Добавлены новые поля классам по отчётам с Telegram бота ([306](https://github.com/MarshalX/yandex-music-api/issues/306), [#398](https://github.com/MarshalX/yandex-music-api/issues/398))**:
- `plus` в `Product`.
- `non_auto_renewable_remainder` в `Subscription`.
- `og_image` в `Artist`.
- `meta_type` в `Album`.
- `advertisement` в `Status`.
- `best` в `Track`.
- `offer_id` и `artist_ids` в `Vinyl`.
- `playlists` в `BriefInfo`.
- `is_custom` в `Cover`.
- `play_count`, `recent`, `chart`, `track` в `TrackShort`.
- `url_part`, `og_title`, `image`, `cover_without_text`, `background_color`, `text_color`, `id_for_from`,`similar_playlists`, `last_owner_playlists` в `Playlist`.
- `bg_color` в `Chart`.
- `error` в `Artist`.
- `substituted`, `matched_track`, `can_publish`, `state`, `desired_visibility`, `filename`, `user_info`, `meta_data` в`Track`.
- `copyright_name`, `copyright_cline` в `Cover`.
- `direct` в `DownloadInfo`.
- `cheapest`, `title`, `family_sub`, `fb_image`, `fb_name`,`family`, `intro_period_duration`, `intro_price`, `start_period_duration`, `start_price`, `licence_text_parts` в `Product`.
- `storage_dir`, `duplicates` в `Album`.
- `subscribed` в `ArtistEvent`.
- `description` в `GeneratedPlaylist`.
- `genre` в `Event`.
- `show_in_regions` в `Genre`.
- `cover_uri` в `MixLink`.
- `og_description`, `top_artist` в `Playlist`.
- `full_image_url`, `mts_full_image_url` в `Station`.
- `coauthors` и `recent_tracks` в `Playlist`.
- `regions` в `User`.
- `users`, `podcasts`, `podcast_episodes`, `type_`, `page`, `per_page` в `Search`.
- `short_description`, `description`, `is_premiere`, `is_banner` в `Like`.
- `master_info` в `AutoRenewable`.
- `station_data` и `bar_below` в `Status`.
- `family_auto_renewable` в `Subscription`.
- `misspell_result` и `misspell_original` в `Search`.
- `experiment` в класс `Status`.
- `operator` и `non_auto_renewable` в `Subscription`.
- `text_color`, `short_description`, `description`, `is_premiere` и `is_banner` в `Album`.
- `hand_made_description` в `Artist`.
- `metrika_id` в `Playlist`.
- `og_image` в `Tag`.
- `url` в `Lyrics`.
- `number`, `genre` в `MetaData`.
- `poetry_lover_matches` в `Track`.
- `contest`, `dummy_description`, `dummy_page_description`, `dummy_cover`, `dummy_rollover_cover`, `og_data`, `branding` в `Playlist`.
- `available_as_rbt`, `lyrics_available`, `remember_position`, `albums`, `duration_ms`, `explicit`, `start_date`, `likes_count`, `deprecation` в `Album`.
- `lyricist`, `version`, `composer` в `MetaData`.
- `last_releases` в `BriefInfo`.
- `ya_money_id` в `Artist` ([351](https://github.com/MarshalX/yandex-music-api/issues/351), [#370](https://github.com/MarshalX/yandex-music-api/issues/370)).
- `playlist_uuid` в `Playlist`.
- `sync_queue_enabled` в `UserSettings`.
- `background_video_uri`, `short_description`, `is_suitable_for_children` в `Track` ([376](https://github.com/MarshalX/yandex-music-api/issues/376)).
- `meta_type`, `likes_count` в `Album` ([386](https://github.com/MarshalX/yandex-music-api/issues/386)).
- `deprecation` в `Album`.
- `available_regions` в `Album`.
- `type`, `ready` в `Playlist`.
- `description` в `Supplement`.
**Незначительные изменения и/или исправления**
- **Добавлена опциональность следующим полям**:
- все поля в `MetaData`.
- `advertisement` в `Status`.
- `text_language` в `Lyrics`.
- `provider_video_id` в `VideoSupplement`.
- `title` в `VideoSupplement` ([403](https://github.com/MarshalX/yandex-music-api/issues/403)).
- `instructions` в `Deactivation` ([402](https://github.com/MarshalX/yandex-music-api/issues/402)).
- `id` в `Album` ([401](https://github.com/MarshalX/yandex-music-api/issues/401)).
- Исправлена десериализация подкастов, эпизодов подкастов и пользователей в лучшем результате поиска.
- Исправлена десериализация альбомов. В зависимости от запроса содержимое лейблов может быть списком объектом или списком строк (в поиске).
- Исправлен выбор настроек радио.
- Исправлены ошибки в документации.
- Протестирована работа на Python 3.9.