Лендинг и фид

class yandex_music._client_async.landing.LandingMixin

Лендинг и фид.

Миксин для методов, связанных с лендингом и фидом.

async feed(*args, **kwargs)

Получение потока информации (фида) подобранного под пользователя. Содержит умные плейлисты.

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Умные плейлисты пользователя или None.

Return type:

yandex_music.Feed | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async feed_wizard_is_passed(*args, **kwargs)

Получение информации о прохождении визарда.

Note

Временное событие на хэллоуин.

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Прошел ли пользователь визард или нет.

Return type:

bool

async landing(blocks, *args, **kwargs)

Получение лендинг-страницы содержащий блоки с новыми релизами, чартами, плейлистами с новинками и т.д.

Note

Поддерживаемые типы блоков: personalplaylists, promotions, new-releases, new-playlists, mixes, chart, artists, albums, playlists, play_contexts.

Parameters:

  • blocks (str | list из str) – Блок или список блоков необходимых для выдачи.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Лендинг-страница или None.

Return type:

yandex_music.Landing | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async chart(chart_option='', *args, **kwargs)

Получение чарта.

Note

chart_option - это постфикс к запросу из поля menu чарта. Например, на сайте можно выбрать глобальный (world) чарт или российский (russia).

Parameters:

  • chart_option (str optional) – Параметры чарта.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Чарт.

Return type:

yandex_music.ChartInfo

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async new_releases(*args, **kwargs)

Получение полного списка всех новых релизов (альбомов).

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Список новых альбомов.

Return type:

yandex_music.LandingList

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async new_playlists(*args, **kwargs)

Получение полного списка всех новых плейлистов.

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Список новых плейлистов.

Return type:

yandex_music.LandingList

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async podcasts(*args, **kwargs)

Получение подкастов с лендинга.

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Список подкастов.

Return type:

yandex_music.LandingList

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async genres(*args, **kwargs)

Получение жанров музыки.

Parameters:

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Жанры музыки или None.

Return type:

list из yandex_music.Genre | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async tags(tag_id, *args, **kwargs)

Получение тега (подборки).

Note

Теги есть в MixLink у Landing, а также плейлистов в .tags.

У MixLink есть URL, но tag_id только его последняя часть. Например, /tag/belarus/. Tag - belarus.

Parameters:

  • tag_id (str) – Уникальный идентификатор тега.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Тег с плейлистами.

Return type:

yandex_music.TagResult

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.