Yandex Music API Files

Переломные изменения

• Поле error класса Artist теперь называется reason.
• Метод users_playlists класса Client теперь возвращает один объект плейлиста, когда был передан один kind. При передаче списка в kind вернётся список плейлистов (#318).
• Поле labels класса Album теперь может содержать список из строк, а не только список объектов класса Label.

Крупные изменения

• Добавлены примеры в папку examples.
• Добавлена поддержка рекомендаций для плейлистов (#324):
  • Добавлен класс PlaylistRecommendations.
  • Добавлен метод клиента для получения рекомендаций (users_playlists_recommendations).
  • Добавлен метод get_recommendations классу Playlist для получения рекомендаций.
• Добавлено получение чартов (#294):
  • Добавлены новые классы: ChartInfo, ChartInfoMenu, ChartInfoMenuItem.
  • Добавлен метод клиента для получения чарта (chart).
• Добавлена поддержка тегов/подборок (#192):
  • Добавлены новые классы: TagResult, Tag.
  • Добавлен новый метод клиента для получения тегов (tags).
• Добавлено присоединение к коллективному плейлисту (#317):
  • Добавлен новый метод клиента для присоединения (playlists_collective_join).
• Добавлена поддержка очередей прослушивания (#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.
  • и другие...
• Добавлена поддержка новых типов поиска: подкасты, выпуски, пользователи.
• Добавлен коллбек для обработки новых полей.
• Добавлена информацию по поводу запуска потока по треку, плейлисту и др.
• Добавлена десериализация decomposed у Artist (#10).
• Добавлен __len__ для TracksList (#380).
• Добавлены __iter__, __len__ и __getitem__ для классов представляющих список каких-либо объектов.
• Добавлено сокращение fetch_tracks классу Playlist для получения треков плейлиста.
• Добавлен метод get_url классу Icon для получения прямой ссылки на изображение.
• Класс User расширен для поддержки поля user_info из Track (поля full_name, display_name).
• Добавлены новые классы по отчётам с Telegram бота (#306, #398):
  • LandingList.
  • RenewableRemainder.
  • Alert.
  • AlertButton.
  • StationData.
  • Brand.
• Contest.
  • OpenGraphData.
  • NonAutoRenewable.
  • Operator.
  • Deactivation.
  • PoetryLoverMatch.
  • Deprecation.
• Добавлены новые поля классам по отчётам с Telegram бота (#306, #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, #370).
  • playlist_uuid в Playlist.
  • sync_queue_enabled в UserSettings.
  • background_video_uri, short_description, is_suitable_for_children в Track (#376).
  • meta_type, likes_count в Album (#386).
  • deprecation в Album.
  • available_regions в Album.
  • type, ready в Playlist.
  • description в Supplement.

Незначительные изменения и/или исправления

• Добавлена опциональность следующим полям:
  • все поля в MetaData.
  • advertisement в Status.
  • text_language в Lyrics.
  • provider_video_id в VideoSupplement.
  • title в VideoSupplement (#403).
  • instructions в Deactivation (#402).
  • id в Album (#401).
• Исправлена десериализация подкастов, эпизодов подкастов и пользователей в лучшем результате поиска.
• Исправлена десериализация альбомов. В зависимости от запроса содержимое лейблов может быть списком объектом или списком строк (в поиске).
• Исправлен выбор настроек радио.
• Исправлены ошибки в документации.
• Протестирована работа на Python 3.9.