Аккаунт

class yandex_music._client_async.account.AccountMixin

Аккаунт.

Миксин для методов, связанных с аккаунтом и настройками.

async init(*args, **kwargs)

Получение информации об аккаунте, использующейся в других запросах.

Parameters:

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

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

Returns:

клиент Yandex Music.

Return type:

yandex_music.ClientAsync

Raises:

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

async account_status(*args, **kwargs)

Получение статуса аккаунта. Нет обязательных параметров.

Parameters:

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

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

Returns:

Информация об аккаунте если он валиден, иначе None.

Return type:

yandex_music.Status | None

Raises:

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

async account_settings(*args, **kwargs)

Получение настроек текущего пользователя.

Parameters:

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

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

Returns:

Настройки пользователя если аккаунт валиден,

иначе None.

Return type:

yandex_music.UserSettings | None

Raises:

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

async account_settings_set(param=None, value=None, data=None, *args, **kwargs)

Изменение настроек текущего пользователя.

Note

Доступные названия параметров есть поля в классе yandex_music.UserSettings, только в CamelCase.

Parameters:

  • param (str) – Название параметра для изменения.

  • value (str | int | bool) – Значение параметра.

  • data (dict) – Словарь параметров и значений для множественного изменения.

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

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

Returns:

Настройки пользователя или None.

Return type:

yandex_music.UserSettings | None

Raises:

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

async settings(*args, **kwargs)

Получение предложений по покупке. Нет обязательных параметров.

Parameters:

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

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

Returns:

Информацию о предлагаемых продуктах если аккаунт валиден

или None.

Return type:

yandex_music.Settings | None

Raises:

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

async permission_alerts(*args, **kwargs)

Получение оповещений. Нет обязательных параметров.

Parameters:

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

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

Returns:

Оповещения если аккаунт валиден или None.

Return type:

yandex_music.PermissionAlerts | None

Raises:

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

async account_experiments(*args, **kwargs)

Получение значений экспериментальных функций аккаунта.

Parameters:

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

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

Returns:

Состояние экспериментальных функций или None.

Return type:

yandex_music.Experiments | None

Raises:

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

async account_experiments_details(*args, **kwargs)

Получение детальной информации об экспериментальных функциях аккаунта.

Note

В отличие от account_experiments(), в ответе для каждого эксперимента возвращается не только выбранная группа, но и её параметры конфигурации.

Parameters:

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

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

Returns:

Детальные значения

экспериментов или None.

Return type:

yandex_music.ExperimentsDetails | None

Raises:

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

async consume_promo_code(code, language=None, *args, **kwargs)

Активация промо-кода.

Note

Доступные языки: en, uz, uk, us, ru, kk, hy.

Parameters:

  • code (str) – Промо-код.

  • language (str, optional) – Язык ответа API в ISO 639-1. По умолчанию язык клиента.

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

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

Returns:

Информация об активации промо-кода или None.

Return type:

yandex_music.PromoCodeStatus | None

Raises:

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