Документация Yandex Music

Yandex Music API

янв. 27, 2021

Оглавление

1 [Alpha] Неофициальная Python библиотека для API Yandex Music1 1.1 Содержание...... 1 1.2 Введение...... 2 1.3 Установка...... 2 1.4 Начало работы...... 2 1.5 Документация...... 5 1.6 Получение помощи...... 5 1.7 Реализации на других языках...... 5 1.8 Разработанные проекты...... 5 1.9 Благодарность...... 7 1.10 Лицензия...... 7

2 Пакет yandex_music 9 2.1 Точка входа yandex_music.Client...... 9 2.2 Родительский объект yandex_music.YandexMusicObject...... 46 2.3 Исключения yandex_music.exceptions...... 48 2.4 Пакет yandex_music.account...... 49 2.5 Пакет yandex_music.album...... 73 2.6 Пакет yandex_music.artist...... 82 2.7 Пакет yandex_music.feed...... 96 2.8 Пакет yandex_music.genre...... 105 2.9 Пакет yandex_music.landing...... 109 2.10 Пакет yandex_music.playlist...... 127 2.11 Пакет yandex_music.queue...... 148 2.12 Пакет yandex_music.rotor...... 151 2.13 Пакет yandex_music.search...... 165 2.14 Пакет yandex_music.shot...... 171 2.15 Пакет yandex_music.supplement...... 175 2.16 Пакет yandex_music.track...... 178 2.17 Пакет yandex_music.utils...... 190 2.18 yandex_music.Cover...... 197 2.19 yandex_music.Like...... 199 2.20 yandex_music.DownloadInfo...... 201 2.21 yandex_music.Experiments...... 203 2.22 yandex_music.Icon...... 203 2.23 yandex_music.InvocationInfo...... 204

i 2.24 yandex_music.Pager...... 205 2.25 yandex_music.PermissionAlerts...... 206 2.26 yandex_music.PromoCodeStatus...... 207 2.27 yandex_music.Settings...... 208 2.28 yandex_music.TrackShort...... 209 2.29 yandex_music.TracksList...... 211 2.30 yandex_music.Video...... 212

3 Список изменений 215 3.1 Версия 0.1.1...... 215 3.2 Версия 0.0.16...... 217 3.3 Версия 0.0.15...... 217 3.4 Версия 0.0.14...... 218

Алфавитный указатель 221

ii Глава 1

[Alpha] Неофициальная Python библиотека для API Yandex Music

Делаю то, что по определённым причинам не сделала компания Yandex. Маленькое сообщество разработчиков общаются и помогают друг другу в Telegram чатике, присоеди- няйтесь!

чат-blue.svg

1.1 Содержание

• Введение 1. Доступ к вашим данным на Яндексе • Установка • Начало работы 1. Изучение по примерам 2. Логирование 3. Документация • Получение помощи

1 Yandex Music API

• Реализации на других языках 1. C# 2. PHP 3. JavaScript • Разработанные проекты 1. Плагин для Kodi 2. Telegram бот-клиент • Благодарность • Лицензия

1.2 Введение

Эта библиотека предоставляется Python интерфейс для никем незадокументированного и сделанного только для себя API Яндекс Музыки. Она совместима с версиями Python 3.6+. В дополнение к реализации чистого API данная библиотека имеет ряд классов-обёрток объектов вы- сокого уровня дабы сделать разработку клиентов и скриптов простой и понятной.

1.2.1 Доступ к вашим данным на Яндексе

Значения констант CLIENT_ID и CLIENT_SECRET позаимствовано у официального приложения- клиента сервиса Яндекс.Музыка из магазина Microsoft Store. Так как API является закрытым и ис- пользуется только внутри компании Яндекс сейчас невозможно зарегистрировать своё собственное приложение на oauth.yandex.ru, а следовательно, использовать свои значения констант.

1.3 Установка

Библиотека находится в стадии разработки Вы можете установить или обновить yandex-music-api при помощи:

$ pip install yandex-music --upgrade

Или Вы можете установить из исходного кода с помощью:

$ git clone https://github.com/MarshalX/yandex-music-api --recursive $ cd yandex-music-api $ python setup.py install

1.4 Начало работы

Приступив к работе первым делом необходимо создать экземпляр клиента. Инициализация клиента:

2 Глава 1. [Alpha] Неофициальная Python библиотека для API Yandex Music Yandex Music API

from yandex_music.client import Client

client= Client()

Для доступа к своим личным данным следует авторизоваться. Это можно осуществить через OAuth токен или логин с паролем. Авторизация по логину и паролю:

from yandex_music.client import Client

client= Client.from_credentials( '[email protected]', 'password')

Авторизация по токену:

from yandex_music.client import Client

client= Client.from_token( 'token') # или client= Client( 'token')

После успешного создания клиента Вы вольны в выборе необходимого метода из API. Все они доступны у объекта класса Client. Подробнее в методах клиента в документации. Пример получения первого трека из плейлиста «Мне нравится» и его загрузка:

from yandex_music.client import Client

client= Client.from_credentials( '[email protected]', 'password') client.users_likes_tracks()[0].fetch_track().download('example.mp3')

В примере выше клиент получает список треков которые были отмечены как понравившиеся. API возвращает объект TracksList в котором содержится список с треками класса TrackShort. Данные класс содержит наиважнейшую информацию о треке и никаких подробностей, поэтому для получения полной версии трека со всей информацией необходимо обратиться к методу fetch_track(). Затем можно скачать трек методом download(). Пример получения треков по ID:

from yandex_music.client import Client

client= Client() client.tracks(['10994777:1193829', '40133452:5206873', '48966383:6693286', '51385674:7163467'])

В качестве ID трека выступает его уникальный номер и номер альбома. Первым треком из примера является следующий трек: music.yandex.ru/album/1193829/track/10994777 Выполнение запросов с использование прокси:

from yandex_music.utils.request import Request from yandex_music.client import Client

request= Request(proxy_url= 'socks5://user:password@host:port') client= Client(request=request)

Примеры proxy url: • socks5://user:password@host:port

1.4. Начало работы 3 Yandex Music API

• http://host:port • https://host:port • http://user:password@host Больше примеров тут: proxies - advanced usage - requests Пример инициализации клиента с обработкой капчи:

def init_client(): client= captcha_key= captcha_answer= None while not client: try: client= Client.from_credentials( 'login', 'pass', captcha_answer, captcha_key) except Captcha as e: e.captcha.download('captcha.png')

captcha_key=e.captcha.x_captcha_key captcha_answer= input( 'Число с картинки: ')

return client

Пример инициализации клиента с обработкой капчи при помощи callback-функции:

def proc_captcha(captcha): captcha.download('captcha.png') return input('Число с картинки: ') client= Client.from_credentials( 'login', 'pass', captcha_callback=proc_captcha)

1.4.1 Изучение по примерам

Вот несколько примеров для обзора. Даже если это не Ваш подход к обучению, пожалуйста, возьмите и бегло просмотрите их. Код примеров опубликован в открытом доступе, поэтому Вы можете взять его и начать писать вокруг своё. Посетите эту страницу чтобы изучить официальные примеры.

1.4.2 Логирование

Данная библиотека использует logging модуль. Чтобы настроить логирование на стандартный вывод, поместите

import logging logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s ')

в начало вашего скрипта. Вы также можете использовать логирование в вашем приложении, вызвав logging.getLogger() и установить уровень какой Вы хотите:

logger= logging.getLogger() logger.setLevel(logging.INFO)

4 Глава 1. [Alpha] Неофициальная Python библиотека для API Yandex Music Yandex Music API

Если Вы хотите DEBUG логирование: logger.setLevel(logging.DEBUG)

1.5 Документация

Документация yandex-music-api расположена на readthedocs.io. Вашей отправной точкой должен быть класс Client, а точнее его методы. Именно они выполняют все запросы на API и возвраща- ют Вам готовые объекты. Класс Client на readthedocs.io.

1.6 Получение помощи

Получить помощь можно несколькими путями: • Задать вопрос в Telegram чатике, где мы помогаем друг другу, присоединяйтесь! • Сообщить о баге, предложить новую фичу или задать вопрос можно создав issue. • Найти ответ на вопрос в документации библиотеки.

1.7 Реализации на других языках

1.7.1C#

Реализация с совершенно другим подходом, так как используется API для frontend’a, а не мобильных и десктопных приложений: Winster332/Yandex.Music.Api. Автор не сильно проявляет активность, но появился форк, который продолжил начатое. Более того, @K1llMan (автор форка) планирует изменить эндпоинты с фронтовых на те, что используются в данной библиотеке. K1llMan/Yandex.Music.Api

1.7.2 PHP

Частично переписанная текущая библиотека на PHP: LuckyWins/yandex-music-api.

1.7.3 JavaScript

API wrapper на Node.JS. Не обновлялся больше двух лет: itsmepetrov/yandex-music-api.

1.8 Разработанные проекты

1.8.1 Плагин для Kodi

Плагин может проигрывать пользовательские плейлисты и плейлисты Яндекса, поиск по Яндекс Му- зыке, радио. Сайт проекта: ymkodi.ml.

1.5. Документация 5 Yandex Music API

Исходный код: kodi.plugin.yandex-music Автор: @Angel777d

1.8.2 Telegram бот-клиент

Неофициальный бот. Умные и ваши плейлисты, понравившиеся треки. Лайки, дизлайки, текста песен, поиск, распознавание песен, похожие треки! Полноценный клиент на базе мессенджера. Сайт проекта: music-yandex-bot.ru Username в Telegram: @music_yandex_bot Статья на habr.com с описанием реализации: Под капотом бота-клиента Яндекс.Музыки Автор: @MarshalX

6 Глава 1. [Alpha] Неофициальная Python библиотека для API Yandex Music Yandex Music API

1.9 Благодарность

Спасибо разработчикам python-telegram-bot. Выбрал Вас в качестве примера.

1.10 Лицензия

Вы можете копировать, распространять и модифицировать программное обеспечение при условии, что модификации описаны и лицензированы бесплатно в соответствии с LGPL-3. Произведения производ- ных (включая модификации или что-либо статически связанное с библиотекой) могут распространять- ся только в соответствии с LGPL-3, но приложения, которые используют библиотеку, необязательно.

1.9. Благодарность 7 Yandex Music API

8 Глава 1. [Alpha] Неофициальная Python библиотека для API Yandex Music Глава 2

Пакет yandex_music

2.1 Точка входа yandex_music.Client class yandex_music.Client(token: str = None, fetch_account_status: bool = True, base_url: str = None, oauth_url: str = None, request: yandex_music.utils.request.Request = None, language: str = ’ru’, report_new_fields=True, report_new_fields_callback: Callable[[object, dict], None] = None) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий клиент Yandex Music.

Примечание: При fetch_account_status = False многие сокращения перестанут работать в связи с тем, что неоткуда будет взять uid аккаунта для отправки запроса. Так же в большинстве методов придётся передавать uid явно. Для отключения предупреждений о новых полях установите report_new_fields в False. Доступные языки: en, uz, uk, us, ru, kk, hy. Поле device используется только при работе с очередью прослушивания.

logger Объект логгера. Type logging.Logger token Уникальный ключ для аутентификации. Type str base_url Ссылка на API Yandex Music.

9 Yandex Music API

Type str oauth_url Ссылка на OAuth Yandex Music. Type str me Информация об аккаунте. Type yandex_music.Status device Строка, содержащая сведения об устройстве, с которого выполняются запросы. Type str report_new_fields Включены ли сообщения о новых полях от API, которых нет в библиотеке. Type bool report_new_fields_callback Функция обратного вызова для обработки новых полей. Принимает объект, в котором нет поля и kwargs с неизвестными полями. Type function

Параметры • token (str, optional) – Уникальный ключ для аутентификации. • fetch_account_status (bool, optional) – Получить ли информацию об аккаунте при инициализации объекта. • base_url (str, optional) – Ссылка на API Yandex Music. • oauth_url (str, optional) – Ссылка на OAuth Yandex Music. • request (yandex_music.utils.request.Request , optional) – Пре- инициализация yandex_music.utils.request.Request . • language (str, optional) – Язык, на котором будут приходить ответы от API. • report_new_fields (bool, optional) – Включить сообщения о новых полях от API, которых нет в библиотеке. • report_new_fields_callback (function, optional) – Функция обратного вызова для обработки новых полей. Принимает объект, в котором нет поля и kwargs с неизвестными полями.

accountExperiments(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.experiments.Experiments] Псевдоним для account_experiments accountSettings(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Псевдоним для account_settings accountSettingsSet(param: str = None, value: Union[str, int, bool] = None, data: Dict[str, Union[str, int, bool]] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Псевдоним для account_settings_set

10 Глава 2. Пакет yandex_music Yandex Music API

accountStatus(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.status.Status] Псевдоним для account_status account_experiments(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.experiments.Experiments] Получение значений экспериментальных функций аккаунта. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Состояние экспериментальных функций или None. Тип результата yandex_music.Experiments | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. account_settings(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Получение настроек текущего пользователя. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Настройки пользователя если аккаунт валиден, иначе None. Тип результата yandex_music.UserSettings | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. account_settings_set(param: str = None, value: Union[str, int, bool] = None, data: Dict[str, Union[str, int, bool]] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Изменение настроек текущего пользователя.

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

Параметры • param (str) – Название параметра для изменения. • value (str | int | bool) – Значение параметра. • data (dict) – Словарь параметров и значений для множественного изменения. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула.

2.1. Точка входа yandex_music.Client 11 Yandex Music API

• **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Настройки пользователя или None. Тип результата yandex_music.UserSettings | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

account_status(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.status.Status] Получение статуса аккаунта. Нет обязательных параметров. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Информация об аккаунте если он валиден, иначе None. Тип результата yandex_music.Status | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. afterTrack(next_track_id: Union[str, int], context_item: str, prev_track_id: Union[str, int] = None, context: str = ’playlist’, types: str = ’shot’, from_: str = ’mobile- landing-origin-default’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.shot.shot_event.ShotEvent] Псевдоним для after_track after_track(next_track_id: Union[str, int], context_item: str, prev_track_id: Union[str, int] = None, context: str = ’playlist’, types: str = ’shot’, from_: str = ’mobile- landing-origin-default’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.shot.shot_event.ShotEvent] Получение рекламы или шота от Алисы после трека.

Примечание: При получения шота от Алисы prev_track_id можно не указывать. Если context = „playlist“, то в context_item необходимо передать {OWNER_PLAYLIST}:{ID_PLAYLIST}. Плейлист с Алисой имеет владельца с id = 940441070. ID плейлиста можно получить из блоков landing’a. Получить шот чужого плейлиста нельзя. Известные значения context: playlist. Известные значения types: shot, ad.

Параметры • prev_track_id (str | int) – Уникальный идентификатор предыдущего трека. • next_track_id (str | int) – Уникальный идентификатор следующего трека. • context_item (str) – Уникальный идентификатор контекста. • context (str, optional) – Место, откуда было вызвано получение.

12 Глава 2. Пакет yandex_music Yandex Music API

• types (str, optional) – Тип того, что вернуть после трека. • from (str, optional) – Место, с которого попали в контекст. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Шот от Алисы или None. Тип результата yandex_music.ShotEvent Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

albums(album_ids: Union[List[Union[str, int]], int, str], timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.album.album.Album] Получение альбома/альбомов. Параметры • album_ids (str | int | list из str | list из int) – Уникальный идентификатор альбома или альбомов. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Альбом или альбомы. Тип результата list из yandex_music.Album Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. albumsWithTracks(album_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.album.album.Album] Псевдоним для albums_with_tracks albums_with_tracks(album_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.album.album.Album] Получение альбома по его уникальному идентификатору вместе с треками. Параметры • album_id (str | int) – Уникальный идентификатор альбома. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Альбом или None. Тип результата list из yandex_music.Album | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

2.1. Точка входа yandex_music.Client 13 Yandex Music API

artists(artist_ids: Union[List[Union[str, int]], int, str], timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.artist.artist.Artist] Получение исполнителя/исполнителей. Параметры • artist_ids (str | int | list из str | list из int) – Уникальный идентифика- тор исполнителя или исполнителей. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Исполнитель или исполнители. Тип результата list из yandex_music.Artist Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. artistsBriefInfo(artist_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.brief_info.BriefInfo] Псевдоним для artists_brief_info artistsDirectAlbums(artist_id: Union[str, int], page: int = 0, page_size: int = 20, sort_by: str = ’year’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.artist_albums.ArtistAlbums] Псевдоним для artists_direct_albums artistsTracks(artist_id: Union[str, int], page: int = 0, page_size: int = 20, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.artist_tracks.ArtistTracks] Псевдоним для artists_tracks artists_brief_info(artist_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.brief_info.BriefInfo] Получение информации об артисте. Параметры • artist_id (str | int) – Уникальный идентификатор исполнителя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Информация об артисте или None. Тип результата yandex_music.BriefInfo | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. artists_direct_albums(artist_id: Union[str, int], page: int = 0, page_size: int = 20, sort_by: str = ’year’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.artist_albums.ArtistAlbums] Получение альбомов артиста.

Примечание: Известные значения для sort_by: year, rating.

14 Глава 2. Пакет yandex_music Yandex Music API

Параметры • artist_id (str | int) – Уникальный идентификатор артиста. • page (int, optional) – Номер страницы. • page_size (int, optional) – Количество альбомов на странице. • sort_by (str, optional) – Параметр для сортировки. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Страница списка альбомов артиста или None. Тип результата yandex_music.ArtistAlbums | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

artists_tracks(artist_id: Union[str, int], page: int = 0, page_size: int = 20, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.artist.artist_tracks.ArtistTracks] Получение треков артиста. Параметры • artist_id (str | int) – Уникальный идентификатор артиста. • page (int, optional) – Номер страницы. • page_size (int, optional) – Количество треков на странице. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Страница списка треков артиста или None. Тип результата yandex_music.ArtistsTracks | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. chart(chart_option: str = ”, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.chart_info.ChartInfo] Получение чарта.

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

Параметры • chart_option (str optional) – Параметры чарта. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула.

2.1. Точка входа yandex_music.Client 15 Yandex Music API

• **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Чарт. Тип результата yandex_music.ChartInfo Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

consumePromoCode(code: str, language: str = ’en’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.promo_code_status.PromoCodeStatus] Псевдоним для consume_promo_code consume_promo_code(code: str, language: str = ’en’, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.promo_code_status.PromoCodeStatus] Активация промо-кода. Параметры • code (str) – Промо-код. • language (str, optional) – Язык ответа API в ISO 639-1. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Информация об активации промо-кода или None. Тип результата yandex_music.PromoCodeStatus | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. feed(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.feed.feed.Feed] Получение потока информации (фида) подобранного под пользователя. Содержит умные плейлисты. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Умные плейлисты пользователя или None. Тип результата yandex_music.Feed | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. feedWizardIsPassed(timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для feed_wizard_is_passed feed_wizard_is_passed(timeout: Union[int, float] = None, *args, **kwargs) → bool

16 Глава 2. Пакет yandex_music Yandex Music API

classmethod fromCredentials(username: str, password: str, x_captcha_answer: str = None, x_captcha_key: str = None, captcha_callback: Callable[[CaptchaResponse], str] = None, *args, **kwargs) → Client Псевдоним для from_credentials classmethod fromToken(token: str, *args, **kwargs) → yandex_music.client.Client Псевдоним для from_token classmethod from_credentials(username: str, password: str, x_captcha_answer: str = None, x_captcha_key: str = None, captcha_callback: Callable[[CaptchaResponse], str] = None, *args, **kwargs) → Client Инициализция клиента по логину и паролю.

Примечание: Данный метод получает токен каждый раз при вызове. Рекомендуется сге- нерировать его самостоятельно, сохранить и использовать при следующих инициализациях клиента. Не храните логины и пароли!

Параметры • username (str) – Логин клиента (идентификатор). • password (str) – Пароль клиента (аутентификатор). • x_captcha_answer (str, optional) – Ответ на капчу (цифры с картинки). • x_captcha_key (str, optional) – Уникальный ключ капчи. • captcha_callback (function, optional) – Функция обратного вызова для об- работки капчи, должна принимать объект класса yandex_music.exceptions. Captcha и возвращать проверочный код. • **kwargs (dict, optional) – Аргументы для конструктора клиента. Результат yandex_music.Client . Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

classmethod from_token(token: str, *args, **kwargs) → yandex_music.client.Client Инициализация клиента по токену.

Примечание: Ничем не отличается от Client(token). Так исторически сложилось.

Параметры • token (str, optional) – Уникальный ключ для аутентификации. • **kwargs (dict, optional) – Аргументы для конструктора клиента. Результат yandex_music.Client .

generateTokenByUsernameAndPassword(username: str, password: str, grant_type: str = ’password’, x_captcha_answer: str = None, x_captcha_key: str = None, timeout: Union[int, float] = None, *args, **kwargs) → str Псевдоним для generate_token_by_username_and_password

2.1. Точка входа yandex_music.Client 17 Yandex Music API

generate_token_by_username_and_password(username: str, password: str, grant_type: str = ’password’, x_captcha_answer: str = None, x_captcha_key: str = None, timeout: Union[int, float] = None, *args, **kwargs) → str Метод получения OAuth токена по логину и паролю. Параметры • username (str) – Логин клиента (идентификатор). • password (str) – Пароль клиента (аутентификатор). • grant_type (str, optional) – Тип разрешения OAuth. • x_captcha_answer (str, optional) – Ответ на капчу (цифры с картинки). • x_captcha_key (str, optional) – Уникальный ключ капчи. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат OAuth токен. Тип результата str Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. genres(timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.genre.genre.Genre] Получение жанров музыки. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Жанры музыки или None. Тип результата list из yandex_music.Genre | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. landing(blocks: Union[str, List[str]], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing.Landing] Получение лендинг-страницы содержащий блоки с новыми релизами, чартами, плейлистами с новинками и т.д.

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

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

18 Глава 2. Пакет yandex_music Yandex Music API

newPlaylists(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing_list.LandingList] Псевдоним для new_playlists newReleases(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing_list.LandingList] Псевдоним для new_releases new_playlists(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing_list.LandingList] Получение полного списка всех новых плейлистов. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Список новых плейлистов. Тип результата yandex_music.LandingList Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. new_releases(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing_list.LandingList] Получение полного списка всех новых релизов (альбомов). Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Список новых альбомов. Тип результата yandex_music.LandingList Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. permissionAlerts(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.permission_alerts.PermissionAlerts] Псевдоним для permission_alerts

2.1. Точка входа yandex_music.Client 19 Yandex Music API

permission_alerts(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.permission_alerts.PermissionAlerts] Получение оповещений. Нет обязательных параметров. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Оповещения если аккаунт валиден или None. Тип результата yandex_music.PermissionAlerts | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. playAudio(track_id: Union[str, int], from_: str, album_id: Union[str, int], playlist_id: str = None, from_cache: bool = False, play_id: str = None, uid: int = None, timestamp: str = None, track_length_seconds: int = 0, total_played_seconds: int = 0, end_position_seconds: int = 0, client_now: str = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для play_audio play_audio(track_id: Union[str, int], from_: str, album_id: Union[str, int], playlist_id: str = None, from_cache: bool = False, play_id: str = None, uid: int = None, timestamp: str = None, track_length_seconds: int = 0, total_played_seconds: int = 0, end_position_seconds: int = 0, client_now: str = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Метод для отправки текущего состояния прослушиваемого трека. Параметры • track_id (str | int) – Уникальный идентификатор трека. • from (str) – Наименования клиента с которого происходит прослушивание. • album_id (str | int) – Уникальный идентификатор альбома. • playlist_id (str, optional) – Уникальный идентификатор плейлиста, если та- ковой прослушивается. • from_cache (bool, optional) – Проигрывается ли трек с кеша. • play_id (str, optional) – Уникальный идентификатор проигрывания. • uid (int, optional) – Уникальный идентификатор пользователя. • timestamp (str, optional) – Текущая дата и время в ISO. • track_length_seconds (int, optional) – Продолжительность трека в секундах. • total_played_seconds (int, optional) – Сколько было всего воспроизведено трека в секундах. • end_position_seconds (int, optional) – Окончательное значение воспроизве- денных секунд. • client_now (str, optional) – Текущая дата и время клиента в ISO. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула.

20 Глава 2. Пакет yandex_music Yandex Music API

• **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. playlistsCollectiveJoin(user_id: int, token: str, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для playlists_collective_join playlistsList(playlist_ids: Union[List[Union[str, int]], int, str], timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.playlist.playlist.Playlist] Псевдоним для playlists_list playlists_collective_join(user_id: int, token: str, timeout: Union[int, float] = None, *args, **kwargs) → bool Присоединение к плейлисту как соавтор.

Примечание: В качестве user_id принимается исключительно числовой уникальный иден- тификатор пользователя, не username. Токен можно получить в Web-версии. Для этого, на странице плейлиста нужно нажать на «Добавить соавтора». В полученной ссылке GET параметр token и будет токеном для при- соединения.

Параметры • user_id (int) – Владелец плейлиста. • token (str) – Токен для присоединения. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs – Произвольные аргументы (будут переданы в запрос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

playlists_list(playlist_ids: Union[List[Union[str, int]], int, str], timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.playlist.playlist.Playlist] Получение плейлиста/плейлистов.

Примечание: Идентификатор плейлиста указывается в формате owner_id:playlist_id. Где playlist_id - идентификатор плейлиста, owner_id - уникальный идентификатор владельца плейлиста.

Параметры • playlist_ids (str | int | list из str | list из int) – Уникальный идентифи- катор плейлиста или плейлистов.

2.1. Точка входа yandex_music.Client 21 Yandex Music API

podcasts(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.landing.landing_list.LandingList] Получение подкастов с лендинга. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Список подскастов. Тип результата yandex_music.LandingList Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. queue(queue_id: str, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.queue.queue.Queue] Получение информации об очереди треков и самих треков в ней. Параметры • queue_id (str) – Уникальный идентификатор очереди. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Очередь или None. Тип результата yandex_music.Queue Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. queueCreate(queue: Union[yandex_music.queue.queue.Queue, str], device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[str] Псевдоним для queue_create queueUpdatePosition(queue_id: str, current_index: int, device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для queue_update_position queue_create(queue: Union[yandex_music.queue.queue.Queue, str], device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[str] Создание новой очереди треков. Параметры

22 Глава 2. Пакет yandex_music Yandex Music API

• queue (yandex_music.Queue | str) – Объект очереди или JSON строка с этим объектом. • device (str, optional) – Содержит информацию об устройстве с которого вы- полняется запрос. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Вернёт уникальный идентификатор созданной очереди, иначе None. Тип результата str Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. queue_update_position(queue_id: str, current_index: int, device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Установка текущего индекса проигрываемого трека в очереди треков.

Примечание: Изменить можно только у той очереди, которая была создана с переданного device!

Параметры • queue_id (str) – Уникальный идентификатор очереди. • current_index (int) – Текущий индекс. • device (str, optional) – Содержит информацию об устройстве с которого вы- полняется запрос. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

queuesList(device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.queue.queue_item.QueueItem] Псевдоним для queues_list queues_list(device: str = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.queue.queue_item.QueueItem] Получение всех очередей треков с разных устройств для синхронизации между ними.

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

2.1. Точка входа yandex_music.Client 23 Yandex Music API

Аргумент device имеет следующий формат: ключ=значение; ключ2=значение2. Обязатель- ные паля указы в значении по умолчанию.

Параметры • device (str, optional) – Содержит информацию об устройстве с которого вы- полняется запрос. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Элементы очереди всех устройств. Тип результата list из yandex_music.QueueItem Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

request Объект вспомогательного класса для отправки запросов. Type yandex_music.utils.request.Request rotorAccountStatus(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.status.Status] Псевдоним для rotor_account_status rotorStationFeedback(station: str, type_: str, timestamp: Union[str, float, int] = None, from_: str = None, batch_id: str = None, total_played_seconds: Union[int, float] = None, track_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_feedback rotorStationFeedbackRadioStarted(station: str, from_: str, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_feedback_radio_started rotorStationFeedbackSkip(station: str, track_id: Union[str, int], total_played_seconds: float, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_feedback_skip rotorStationFeedbackTrackFinished(station: str, track_id: Union[str, int], total_played_seconds: float, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_feedback_track_finished rotorStationFeedbackTrackStarted(station: str, track_id: Union[str, int], batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_feedback_track_started rotorStationInfo(station: str, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.rotor.station_result.StationResult] Псевдоним для rotor_station_info

24 Глава 2. Пакет yandex_music Yandex Music API

rotorStationSettings2(station: str, mood_energy: str, diversity: str, language: str = ’not- russian’, type_: str = ’rotor’, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для rotor_station_settings2 rotorStationTracks(station: str, settings2: bool = True, queue: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.rotor.station_tracks_result.StationTracksResult] Псевдоним для rotor_station_tracks rotorStationsDashboard(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.rotor.dashboard.Dashboard] Псевдоним для rotor_stations_dashboard rotorStationsList(language: str = ’ru’, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.rotor.station_result.StationResult] Псевдоним для rotor_stations_list rotor_account_status(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.status.Status] Получение статуса пользователя с дополнителньыми полями.

Примечание: Данный статус отличается от обычного наличием дополнительных полей, например, skips_per_hour.

Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Статус пользователя с дополнительными полями от радио или None. Тип результата yandex_music.Status | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

rotor_station_feedback(station: str, type_: str, timestamp: Union[str, float, int] = None, from_: str = None, batch_id: str = None, total_played_seconds: Union[int, float] = None, track_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Отправка ответной реакции на происходящее при прослушивании радио.

Примечание: Сообщения о начале прослушивания радио, начале и конце трека, его про- пуска. Известные типы фидбека: radioStarted, trackStarted, trackFinished, skip. Пример station: user:onyourwave, genre:allrock. Пример from_: mobile-radio-user-123456789.

Параметры

2.1. Точка входа yandex_music.Client 25 Yandex Music API

• station (str) – Станция. • type (str) – Тип отправляемого фидбека. • timestamp (str | float | int, optional) – Текущее время и дата. • from (str, optional) – Откуда начато воспроизведение радио. • batch_id (str, optional) – Уникальный идентификатор партии треков. Воз- вращается при получении треков. • total_played_seconds (int |float, optional) – Сколько было проиграно секунд трека перед действием. • track_id (int | str, optional) – Уникальной идентификатор трека. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

rotor_station_feedback_radio_started(station: str, from_: str, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Сокращение для:

client.rotor_station_feedback(station, 'radioStarted', timestamp, from,*args,**kwargs)

Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

rotor_station_feedback_skip(station: str, track_id: Union[str, int], total_played_seconds: float, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Сокращение для:

client.rotor_station_feedback(station, 'skip', timestamp, track_id, total_played_seconds, *args,**kwargs)

26 Глава 2. Пакет yandex_music Yandex Music API

rotor_station_feedback_track_finished(station: str, track_id: Union[str, int], total_played_seconds: float, batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Сокращение для:

client.rotor_station_feedback(station, 'trackFinished', timestamp, track_id, total_ ˓→played_seconds, *args,**kwargs)

rotor_station_feedback_track_started(station: str, track_id: Union[str, int], batch_id: str = None, timestamp: Union[str, float, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Сокращение для:

client.rotor_station_feedback(station, 'trackStarted', timestamp, track_id,*args,␣ ˓→**kwargs)

rotor_station_info(station: str, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.rotor.station_result.StationResult] Получение информации о станции и пользовательских настроек на неё. Параметры • station (str) – Станция. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Информация о станции или None. Тип результата list из yandex_music.StationResult | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. rotor_station_settings2(station: str, mood_energy: str, diversity: str, language: str = ’not- russian’, type_: str = ’rotor’, timeout: Union[int, float] = None, *args, **kwargs) → bool Изменение настроек определённой станции.

2.1. Точка входа yandex_music.Client 27 Yandex Music API

Примечание: Доступные значения для mood_energy: fun, active, calm, sad, all. Доступные значения для diversity: favorite, popular, discover, default. Доступные значения для language: not-russian, russian, any. Доступные значения для type_: rotor, generative. У станций в restrictions есть Enum’ы, а в них possible_values - доступные значения для поля.

Параметры • station (str) – Станция. • mood_energy (str) – Настроение. • diversity (str) – Треки. • language (str) – Язык. • type (str) – Тип. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

rotor_station_tracks(station: str, settings2: bool = True, queue: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.rotor.station_tracks_result.StationTracksResult] Получение цепочки треков определённой станции.

Примечание: Запуск потока по сущности сервиса осуществляется через станцию :. Например, станцией для запуска потока по треку будет track:1234. Для продолжения цепочки треков необходимо: 1. Передавать ID трека, что был до этого (первый в цепочки). 2. Отправить фидбек о конче или скипе трека, что был передан в queue. 3. Отправить фидбек о начале следующего трека (второй в цепочки). 4. Выполнить запрос получения треков. В ответе придёт новые треки или произойдёт сдвиг цепочки на 1 элемент. Проход по цепочке до коцна не изучен. Часто встречаются дубликаты. Все официальные клиенты выполняют запросы с settings2 = True.

Параметры • station (str) – Станция.

28 Глава 2. Пакет yandex_music Yandex Music API

• settings2 (bool, optional) – Использовать ли второй набор настроек. • queue (str | int , optional) – Уникальной идентификатор трека, который толь- ко что был. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Последовательность треков станции или None. Тип результата yandex_music.StationTracksResult | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

rotor_stations_dashboard(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.rotor.dashboard.Dashboard] Получение рекомендованных станций текущего пользователя. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Рекомендованные станции или None. Тип результата yandex_music.Dashboard | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. rotor_stations_list(language: str = ’ru’, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.rotor.station_result.StationResult] Получение всех радиостанций с настройками пользователя.

Примечание: Чтобы определить что за тип станции (жанры, настроения, занятие и т.д.) необходимо смотреть в поле id_for_from.

Параметры • language (str) – Язык, на котором будет информация о станциях. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Станции или None. Тип результата list из yandex_music.StationResult | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

2.1. Точка входа yandex_music.Client 29 Yandex Music API

search(text: str, nocorrect: bool = False, type_: str = ’all’, page: int = 0, playlist_in_best: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.search.search.Search] Осуществление поиска по запросу и типу, получение результатов.

Примечание: Известные значения для поля type_: all, artist, user, album, playlist, track, podcast, podcast_episode. При поиске type=all не возвращаются подкасты и эпизоды. Указывайте конкретный тип для поиска.

Параметры • text (str) – Текст запроса. • nocorrect (bool) – Если False, то ошибочный запрос будет исправлен. На- пример, запрос «Гражданская абарона» будет исправлен на «Гражданская оборона». • type (str) – Среди какого типа искать (трек, плейлист, альбом, исполнитель, пользователь, подкаст). • page (int) – Номер страницы. • playlist_in_best (bool) – Выдавать ли плейлисты лучшим вариантом поис- ка. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Результаты поиска или None. Тип результата yandex_music.Search | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

searchSuggest(part: str, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.search.suggestions.Suggestions] Псевдоним для search_suggest search_suggest(part: str, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.search.suggestions.Suggestions] Получение подсказок по введенной части поискового запроса. Параметры • part (str) – Часть поискового запроса. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Подсказки для запроса или None. Тип результата yandex_music.Suggestions | None

30 Глава 2. Пакет yandex_music Yandex Music API

Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. settings(timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.settings.Settings] Получение предложений по покупке. Нет обязательных параметров. Параметры • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Информацию о предлагаемых продуктах если аккаунт валиден или None. Тип результата yandex_music.Settings | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. tags(tag_id: str, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.tag_result.TagResult] Получение тега (подборки).

Примечание: Теги есть в MixLink у Landing, а также плейлистов в .tags. У MixLink есть URL, но tag_id только его последняя часть. Например, /tag/belarus/. Tag - belarus.

Параметры • tag_id (str) – Уникальный идентификатор тега. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Тег с плейлистами. Тип результата yandex_music.TagResult Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

trackSupplement(track_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.supplement.supplement.Supplement] Псевдоним для track_supplement track_supplement(track_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.supplement.supplement.Supplement] Получение дополнительной информации о треке. Параметры • track_id (str) – Уникальный идентификатор трека.

2.1. Точка входа yandex_music.Client 31 Yandex Music API

• timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Дополнительная информация о треке. Тип результата yandex_music.Supplement Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. tracks(track_ids: Union[List[Union[str, int]], int, str], with_positions: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.track.track.Track] Получение трека/треков. Параметры • track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков. • with_positions (bool, optional) – С позициями TODO. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Трек или Треки. Тип результата list из yandex_music.Track Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. tracksDownloadInfo(track_id: Union[str, int], get_direct_links: bool = False, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.download_info.DownloadInfo] Псевдоним для tracks_download_info tracksSimilar(track_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.track.tracks_similar.SimilarTracks] Псевдоним для tracks_similar tracks_download_info(track_id: Union[str, int], get_direct_links: bool = False, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.download_info.DownloadInfo] Получение информации о доступных вариантах загрузки трека. Параметры • track_id (str | list из str) – Уникальный идентификатор трека или треков. • get_direct_links (bool, optional) – Получить ли при вызове метода прямую ссылку на загрузку. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Варианты загрузки трека или None.

32 Глава 2. Пакет yandex_music Yandex Music API

Тип результата list из yandex_music.DownloadInfo | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. tracks_similar(track_id: Union[str, int], timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.track.tracks_similar.SimilarTracks] Получение похожих треков. Параметры • track_id (str) – Уникальный идентификатор трека. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Похожие треки на другой трек. Тип результата yandex_music.SimilarTracks Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. usersDislikesTracks(user_id: Union[str, int] = None, if_modified_since_revision: int = 0, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.tracks_list.TracksList] Псевдоним для users_dislikes_tracks usersDislikesTracksAdd(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_dislikes_tracks_add usersDislikesTracksRemove(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_dislikes_tracks_remove usersLikesAlbums(user_id: Union[str, int] = None, rich: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Псевдоним для users_likes_albums usersLikesAlbumsAdd(album_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_albums_add usersLikesAlbumsRemove(album_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_albums_remove usersLikesArtists(user_id: Union[str, int] = None, with_timestamps: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Псевдоним для users_likes_artists usersLikesArtistsAdd(artist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_artists_add

2.1. Точка входа yandex_music.Client 33 Yandex Music API

usersLikesArtistsRemove(artist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_artists_remove usersLikesPlaylists(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Псевдоним для users_likes_playlists usersLikesPlaylistsAdd(playlist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_playlists_add usersLikesPlaylistsRemove(playlist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_playlists_remove usersLikesTracks(user_id: Union[str, int] = None, if_modified_since_revision: int = 0, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.tracks_list.TracksList] Псевдоним для users_likes_tracks usersLikesTracksAdd(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_tracks_add usersLikesTracksRemove(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_likes_tracks_remove usersPlaylists(kind: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Union[yandex_music.playlist.playlist.Playlist, List[yandex_music.playlist.playlist.Playlist]] Псевдоним для users_playlists usersPlaylistsChange(kind: Union[str, int], diff: str, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_change usersPlaylistsCreate(title: str, visibility: str = ’public’, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_create usersPlaylistsDelete(kind: Union[str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Псевдоним для users_playlists_delete usersPlaylistsDeleteTrack(kind: Union[str, int], from_: int, to: int, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_delete_track

34 Глава 2. Пакет yandex_music Yandex Music API

usersPlaylistsInsertTrack(kind: Union[str, int], track_id: Union[str, int], album_id: Union[str, int], at: int = 0, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_insert_track usersPlaylistsList(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_list usersPlaylistsName(kind: Union[str, int], name: str, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_name usersPlaylistsRecommendations(kind: Union[str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) Псевдоним для users_playlists_recommendations usersPlaylistsVisibility(kind: Union[str, int], visibility: str, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Псевдоним для users_playlists_visibility usersSettings(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Псевдоним для users_settings users_dislikes_tracks(user_id: Union[str, int] = None, if_modified_since_revision: int = 0, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.tracks_list.TracksList] Получение треков с отметкой «Не рекомендовать». Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • if_modified_since_revision (bool, optional) – TODO. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Треки с отметкой «Не рекомендовать». Тип результата list из yandex_music.TracksList Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_dislikes_tracks_add(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Поставить отметку «Не рекомендовать» треку/трекам.

Примечание: Так же снимает отметку «Мне нравится» если она есть.

Параметры

2.1. Точка входа yandex_music.Client 35 Yandex Music API

• track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_dislikes_tracks_remove(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Снять отметку «Не рекомендовать» у трека/треков. Параметры • track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_albums(user_id: Union[str, int] = None, rich: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Получение альбомов с отметкой «Мне нравится». Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • rich (bool, optional) – Если False, то приходит укороченная версия. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Альбомы с отметкой «Мне нравится». Тип результата list из yandex_music.Like

36 Глава 2. Пакет yandex_music Yandex Music API

Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_albums_add(album_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Поставить отметку «Мне нравится» альбому/альбомам. Параметры • album_ids (str | int | list из str | list из int) – Уникальный идентификатор артиста или артистов. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_albums_remove(album_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Снять отметку «Мне нравится» у альбома/альбомов. Параметры • album_ids (str | int | list из str | list из int) – Уникальный идентификатор артиста или артистов. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_artists(user_id: Union[str, int] = None, with_timestamps: bool = True, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Получение артистов с отметкой «Мне нравится». Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

2.1. Точка входа yandex_music.Client 37 Yandex Music API

• with_timestamps (bool, optional) – С временными метками TODO. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Артисты с отметкой «Мне нравится». Тип результата list из yandex_music.Like Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_artists_add(artist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Поставить отметку «Мне нравится» исполнителю/исполнителям. Параметры • artist_ids (str | int | list из str | list из int) – Уникальный идентифика- тор артиста или артистов. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_artists_remove(artist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Снять отметку «Мне нравится» у исполнителя/исполнителей. Параметры • artist_ids (str | int | list из str | list из int) – Уникальный идентифика- тор артиста или артистов. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

38 Глава 2. Пакет yandex_music Yandex Music API

users_likes_playlists(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.like.Like] Получение плейлистов с отметкой «Мне нравится». Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Плейлисты с отметкой «Мне нравится». Тип результата list из yandex_music.Like Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_playlists_add(playlist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Поставить отметку «Мне нравится» плейлисту/плейлистам.

Параметры • playlist_ids (str | int | list из str | list из int) – Уникальный идентифи- катор плейлиста или плейлистов. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_likes_playlists_remove(playlist_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Снять отметку «Мне нравится» у плейлиста/плейлистов.

2.1. Точка входа yandex_music.Client 39 Yandex Music API

плейлиста.

users_likes_tracks(user_id: Union[str, int] = None, if_modified_since_revision: int = 0, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.tracks_list.TracksList] Получение треков с отметкой «Мне нравится». Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • if_modified_since_revision (int, optional) – TODO. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Треки с отметкой «Мне нравится». Тип результата yandex_music.TracksList Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_likes_tracks_add(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Поставить отметку «Мне нравится» треку/трекам.

Примечание: Так же снимает отметку «Не рекомендовать» если она есть.

Параметры • track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков.

40 Глава 2. Пакет yandex_music Yandex Music API

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_likes_tracks_remove(track_ids: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Снять отметку «Мне нравится» у трека/треков. Параметры • track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков. • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists(kind: Union[List[Union[str, int]], str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Union[yandex_music.playlist.playlist.Playlist, List[yandex_music.playlist.playlist.Playlist]] Получение плейлиста или списка плейлистов по уникальным идентификаторам.

Примечание: Если передан один kind, то вернётся не список плейлистов, а один плейлист.

Параметры • kind (str | int | list из str | int) – Уникальный идентификатор плейлиста или их список. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула.

2.1. Точка входа yandex_music.Client 41 Yandex Music API

• **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Список плейлистов или плейлист, иначе None. Тип результата list из yandex_music.Playlist | yandex_music.Playlist | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_playlists_change(kind: Union[str, int], diff: str, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Изменение плейлиста.

Примечание: Для получения отличий есть вспомогательный класс yandex_music.utils. difference.Difference . Так же существуют уже готовые методы-обёртки над операциями.

Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • revision (int) – TODO. • diff (str) – JSON представления отличий старого и нового плейлиста. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Изменённый плейлист или None. Тип результата yandex_music.Playlist Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_playlists_create(title: str, visibility: str = ’public’, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Создание плейлиста. Параметры • title (str) – Название. • visibility (str, optional) – Модификатор доступа. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула.

42 Глава 2. Пакет yandex_music Yandex Music API

• **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Созданный плейлист или None. Тип результата yandex_music.Playlist | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists_delete(kind: Union[str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → bool Удаление плейлиста. Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат True при успешном выполнении запроса, иначе False. Тип результата bool Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists_delete_track(kind: Union[str, int], from_: int, to: int, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Удаление треков из плейлиста.

Примечание: Для удаление необходимо указать границы с какого по какой элемент (трек) удалить.

Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • from (int) – С какого индекса. • to (int) – По какой индекс. • revision (int) – TODO. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Изменённый плейлист или None.

2.1. Точка входа yandex_music.Client 43 Yandex Music API

Тип результата yandex_music.Playlist | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_playlists_insert_track(kind: Union[str, int], track_id: Union[str, int], album_id: Union[str, int], at: int = 0, revision: int = 1, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Добавление трека в плейлист.

Примечание: Трек можно вставить с любое место плейлиста задав индекс вставки (аргу- мент at).

Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • track_id (str | int) – Уникальный идентификатор трека. • album_id (str | int) – Уникальный идентификатор альбома. • at (int) – Индекс для вставки. • revision (int) – TODO. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Изменённый плейлист или None. Тип результата yandex_music.Playlist Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_playlists_list(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → List[yandex_music.playlist.playlist.Playlist] Получение списка плейлистов пользователя. Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Плейлисты пользователя. Тип результата list из yandex_music.Playlist

44 Глава 2. Пакет yandex_music Yandex Music API

Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists_name(kind: Union[str, int], name: str, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Изменение названия плейлиста. Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • name (str) – Новое название. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Изменённый плейлист или None. Тип результата yandex_music.Playlist | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists_recommendations(kind: Union[str, int], user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) Получение рекомендаций для плейлиста. Параметры • kind (str | int) – Уникальный идентификатор плейлиста. • user_id (str | int) – Уникальный идентификатор пользователя владеющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Рекомендации для плейлиста или None. Тип результата yandex_music.PlaylistRecommendations | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. users_playlists_visibility(kind: Union[str, int], visibility: str, user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.playlist.playlist.Playlist] Изменение видимости плейлиста.

Примечание: Видимость (visibility) может быть задана только одним из двух значений: private, public.

Параметры

2.1. Точка входа yandex_music.Client 45 Yandex Music API

• kind (str | int) – Уникальный идентификатор плейлиста. • visibility (str) – Новое название. • user_id (str | int, optional) – Уникальный идентификатор пользователя вла- деющим плейлистом. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Изменённый плейлист или None. Тип результата yandex_music.Playlist | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

users_settings(user_id: Union[str, int] = None, timeout: Union[int, float] = None, *args, **kwargs) → Optional[yandex_music.account.user_settings.UserSettings] Получение настроек пользователя.

Примечание: Для получения настроек пользователя нужно быть авторизованным или владеть user_id.

Параметры • user_id (str | int, optional) – Уникальный идентификатор пользователя чьи настройки хотим получить. • timeout (int | float, optional) – Если это значение указано, используется как время ожидания ответа от сервера вместо указанного при создании пула. • **kwargs (dict, optional) – Произвольные аргументы (будут переданы в за- прос). Результат Настройки пользователя или None. Тип результата yandex_music.UserSettings | None Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

2.2 Родительский объект yandex_music.YandexMusicObject class yandex_music.YandexMusicObject Базовые классы: object __annotations__ = {'_id_attrs': } __dict__ = mappingproxy({'__module__': 'yandex_music.base', '__annotations__':{'_id_attrs': }, '__metaclass__': , '_id_attrs': (), '__str__': , '__repr__': , '__getitem__': , 'report_new_fields_callback': , 'handle_unknown_kwargs': , 'de_json': , 'to_json': , 'to_dict': , '__eq__': , '__hash__': , '__dict__': , '__weakref__': , '__doc__': None}) __eq__(other) → bool Проверка на равенство двух объектов.

46 Глава 2. Пакет yandex_music Yandex Music API

Примечание: Проверка осуществляется по определённым атрибутам классов, перечислен- ных в множестве _id_attrs.

Результат Одинаковые ли объекты (по содержимому). Тип результата bool

__getitem__(item) __hash__() → int Реализация хеш-функции на основе ключевых атрибутов.

Примечание: Так как перечень ключевых атрибутов хранится в виде множества, для вычисления хеша он замораживается.

Результат Хеш объекта. Тип результата int

__metaclass__ псевдоним класса abc.ABCMeta __module__ = 'yandex_music.base' __repr__() → str Return repr(self). __str__() → str Return str(self). __weakref__ list of weak references to the object (if defined) _id_attrs = () classmethod de_json(data: dict, client: Optional[Client]) → Optional[dict] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат yandex_music.YandexMusicObject или None. Тип результата yandex_music.YandexMusicObject | None static handle_unknown_kwargs(obj, **kwargs) static report_new_fields_callback(obj, new_fields) to_dict(for_request=False) → dict Рекурсивная сериализация объекта. Параметры for_request (bool) – Перевести ли обратно все поля в camelCase и игнорировать зарезервированные слова.

2.2. Родительский объект yandex_music.YandexMusicObject 47 Yandex Music API

Примечание: Исключает из сериализации client и _id_attrs необходимые в __eq__. К зарезервированным именам добавляет «_» в конец.

Результат Сериализованный в dict объект. Тип результата dict

to_json(for_request=False) → str Сериализация объекта. Параметры for_request (bool) – Подготовить ли объект для отправки в теле за- проса. Результат Сериализованный в JSON объект. Тип результата str

2.3 Исключения yandex_music.exceptions class yandex_music.exceptions.YandexMusicError Базовые классы: Exception Базовый класс, представляющий исключения общего характера. class yandex_music.exceptions.InvalidToken Базовые классы: yandex_music.exceptions.YandexMusicError Класс исключения, вызываемого для случаев недействительного или неверного токена аутенти- фикации. class yandex_music.exceptions.Unauthorized Базовые классы: yandex_music.exceptions.YandexMusicError Класс исключения, вызываемого для случаев ошибок аутентификации и авторизации. class yandex_music.exceptions.InvalidBitrate Базовые классы: yandex_music.exceptions.YandexMusicError Класс исключения, вызываемого при попытке загрузки трека с недоступным битрейтом. class yandex_music.exceptions.Captcha(msg: str, captcha: CaptchaResponse, *args, **kwargs) Базовые классы: yandex_music.exceptions.YandexMusicError Базовый класс, представляющий исключение связанное с капчей. captcha Капча. Type yandex_music.utils.captcha_response.CaptchaResponse

Параметры • msg (str) – Сообщение с ошибкой. • captcha (yandex_music.utils.captcha_response.CaptchaResponse ) – Капча.

48 Глава 2. Пакет yandex_music Yandex Music API

class yandex_music.exceptions.CaptchaRequired(msg: str, captcha: CaptchaResponse, *args, **kwargs) Базовые классы: yandex_music.exceptions.Captcha Класс исключения, вызываемый в случае необходимости ввода проверочного кода. class yandex_music.exceptions.CaptchaWrong(msg: str, captcha: CaptchaResponse, *args, **kwargs) Базовые классы: yandex_music.exceptions.Captcha Класс исключения, вызываемый в случае неправильного ввода капчи. class yandex_music.exceptions.NetworkError Базовые классы: yandex_music.exceptions.YandexMusicError Базовый класс исключений, вызываемых для ошибок, связанных с запросами к серверу. class yandex_music.exceptions.BadRequest Базовые классы: yandex_music.exceptions.NetworkError Класс исключения, вызываемый в случае отправки неправильного запроса. class yandex_music.exceptions.TimedOut Базовые классы: yandex_music.exceptions.NetworkError Класс исключения, вызываемого для случаев истечения времени ожидания.

2.4 Пакет yandex_music.account

2.4.1 yandex_music.Status class yandex_music.Status(account: Optional[Account], permissions: Optional[Permissions], advertisement: Optional[str] = None, subscription: Optional[Subscription] = None, cache_limit: Optional[int] = None, subeditor: Optional[bool] = None, subeditor_level: Optional[int] = None, plus: Optional[Plus] = None, default_email: Optional[str] = None, skips_per_hour: Optional[int] = None, station_exists: Optional[bool] = None, station_data: Optional[StationData] = None, bar_below: Optional[Alert] = None, premium_region: Optional[int] = None, experiment: Optional[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий подробную информацию об аккаунте пользователя. account Основная информация об аккаунте. Type yandex_music.Account permissions Информация о правах пользователя. Type yandex_music.Permissions advertisement Рекламное объявление.

2.4. Пакет yandex_music.account 49 Yandex Music API

Type str subscription Информация о подписках. Type yandex_music.Subscription cache_limit Максимальное количество загруженных треков. Type int subeditor Наличие статуса модератора проверки корректности информации. Type bool subeditor_level Уровень статуса модератора. Type int plus Информация о Plus подписке. Type yandex_music.Plus default_email Основной e-mail адрес аккаунта. Type str skips_per_hour Количество переключение треков на радио в час. Type int station_exists Наличие личной станции. Type bool station_data Информация о личной станции. Type yandex_music.StationData bar_below Блок с предупреждениями о конце подписке и подарках. Type yandex_music.Alert premium_region Регион TODO. Type int experiment Включенная новая фича на аккаунте (её ID) TODO. Type int client Клиент Yandex Music. Type yandex_music.Client

50 Глава 2. Пакет yandex_music Yandex Music API

Параметры • account (yandex_music.Account ) – Основная информация об аккаунте • permissions (yandex_music.Permissions ) – Информация о правах пользовате- ля. • advertisement (str, optional) – Рекламное объявление. • subscription (yandex_music.Subscription , optional) – Информация о подпис- ках. • cache_limit (int, optional) – Максимальное количество загруженных треков. • subeditor (bool, optional) – Наличие статуса модератора проверки корректно- сти информации. • subeditor_level (int, optional) – Уровень статуса модератора. • plus (yandex_music.Plus , optional) – Информация о Plus подписке. • default_email (str, optional) – Основной e-mail адрес аккаунта. • skips_per_hour (int, optional) – Количество переключение треков на радио в час. • station_exists (bool, optional) – Наличие личной станции. • station_data (yandex_music.StationData , optional) – Информация о личной станции. • bar_below (yandex_music.Alert , optional) – Блок с предупреждениями о конце подписке и подарках. • premium_region (int, optional) – Регион TODO. • experiment (int, optional) – Включенная новая фича на аккаунте (её ID) TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Status] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация об аккаунте пользователя. Тип результата yandex_music.Status

2.4. Пакет yandex_music.account 51 Yandex Music API

2.4.2 yandex_music.Account class yandex_music.Account(now: str, service_available: bool, region: Optional[int] = None, uid: Optional[int] = None, login: Optional[str] = None, full_name: Optional[str] = None, second_name: Optional[str] = None, first_name: Optional[str] = ,None display_name: Optional[str] = None, hosted_user: Optional[bool] = None, birthday: Optional[str] = None, passport_phones: List[PassportPhone] = None, registered_at: Optional[str] = None, has_info_for_app_metrica: bool = False, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий основную информацию об аккаунте пользователя. now Текущая дата и время. Type str uid Уникальный идентификатор. Type int login Виртуальное имя (обычно e-mail). Type str full_name Полное имя (имя и фамилия). Type str second_name Фамилия. Type str first_name Имя. Type str display_name Отображаемое имя. Type str birthday Дата рождения. Type str service_available Доступен ли сервис. Type bool hosted_user Является ли пользователем чьим-то другим. Type bool

52 Глава 2. Пакет yandex_music Yandex Music API

region Регион. Type int passport_phones Мобильные номера. Type list из yandex_music.PassportPhone registered_at Дата создания аккаунта. Type str has_info_for_app_metrica Наличие информации для App Metrica. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • now (str) – Текущая дата и время. • uid (int, optional) – Уникальный идентификатор. • login (str, optional) – Виртуальное имя (обычно e-mail). • full_name (str, optional) – Полное имя (имя и фамилия). • second_name (str, optional) – Фамилия. • first_name (str, optional) – Имя. • display_name (str, optional) – Отображаемое имя. • service_available (bool) – Доступен ли сервис. • hosted_user (bool, optional) – Является ли пользователем чьим-то другим. • birthday (str, optional) – Дата рождения. • region (int, optional) – Регион. • passport_phones (list из yandex_music.PassportPhone ) – Мобильные номера. • registered_at (str, optional) – Дата создания учётной записи. • has_info_for_app_metrica (bool, optional) – Наличие информации для App Metrica. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Account] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

2.4. Пакет yandex_music.account 53 Yandex Music API

Результат Основная информация об аккаунте пользователя. Тип результата yandex_music.Account downloadAvatar(filename: str, format_: str = ’normal’) → None Псевдоним для download_avatar download_avatar(filename: str, format_: str = ’normal’) → None Загрузка изображения пользователя. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • format (str) – Формат желаемого изображения (normal, orig, small, big).

2.4.3 yandex_music.PassportPhone class yandex_music.PassportPhone(phone: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий номер телефона пользователя. phone Номер телефона. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • phone (str) – Номер телефона. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PassportPhone] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Номер телефона пользователя. Тип результата yandex_music.PassportPhone classmethod de_list(data: dict, client: Client) → List[PassportPhone] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Номера телефонов пользователя.

54 Глава 2. Пакет yandex_music Yandex Music API

Тип результата list из yandex_music.PassportPhone

2.4.4 yandex_music.Plus

class yandex_music.Plus(has_plus: bool, is_tutorial_completed: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий Plus подписку. has_plus Наличие. Type bool is_tutorial_completed Закончено ли руководство. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • has_plus (bool) – Наличие. • is_tutorial_completed (bool) – Закончено ли руководство. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Plus] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Plus подписка. Тип результата yandex_music.Plus

2.4.5 yandex_music.Permissions class yandex_music.Permissions(until: str, values: List[str], default: List[str], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию о правах пользователя, их изначальных значениях и даты окончания. until Дата окончания прав. Type str

2.4. Пакет yandex_music.account 55 Yandex Music API

values Список прав. Type list из str default Список изначальных прав. Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • until (str) – Дата окончания прав. • values (list из str) – Список прав. • default (list из str) – Список изначальных прав. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Permissions] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация о правах пользователя, их изначальных значениях и даты окончания. Тип результата yandex_music.Permissions

2.4.6 yandex_music.Subscription class yandex_music.Subscription(non_auto_renewable_remainder: RenewableRemainder, auto_renewable: List[AutoRenewable], family_auto_renewable: List[AutoRenewable], operator: List[Operator] = None, non_auto_renewable: Optional[NonAutoRenewable] = None, can_start_trial: Optional[bool] = None, mcdonalds: Optional[bool] = None, end: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию о подписках пользователя. non_auto_renewable_remainder Напоминание о продлении. Type yandex_music.RenewableRemainder auto_renewable Автопродление подписки.

56 Глава 2. Пакет yandex_music Yandex Music API

Type list из yandex_music.AutoRenewable family_auto_renewable Автопродление семейной подписки. Type list из yandex_music.AutoRenewable operator Услуги сотового оператора. Type list из yandex_music.Operator non_auto_renewable Отключённое автопродление. Type yandex_music.NonAutoRenewable can_start_trial Есть ли возможность начать пробный период. Type bool mcdonalds mcdonalds TODO. Type bool end Дата окончания. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • non_auto_renewable_remainder (yandex_music.RenewableRemainder) – Напо- минание о продлении. • auto_renewable (list из yandex_music.AutoRenewable , optional) – Автопродле- ние. • family_auto_renewable (list из yandex_music.AutoRenewable ) – Автопродле- ние семейной подписки. • operator (list из yandex_music.Operator , optional) – Услуги сотового опера- тора. • non_auto_renewable (yandex_music.NonAutoRenewable , optional) – Отключён- ное автопродление. • can_start_trial (bool, optional) – Есть ли возможность начать пробный пери- од. • mcdonalds (bool, optional) – mcdonalds TODO. • end (str, optional) – Дата окончания. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.4. Пакет yandex_music.account 57 Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[Subscription] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация о подписках пользователя. Тип результата yandex_music.Subscription

2.4.7 yandex_music.AutoRenewable class yandex_music.AutoRenewable(expires: str, vendor: str, vendor_help_url: str, product: Optional[Product], finished: bool, master_info: Optional[User] = None, product_id: Optional[str] = None, order_id: Optional[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию об автопродлении подписки. expires Дата истечения подписки. Type str vendor Продавец. Type str vendor_help_url Ссылка на страницу помощи продавца. Type str product_id Уникальный идентификатор продукта. Type str master_info Главный в семейной подписке. Type yandex_music.User product Продукт. Type yandex_music.Product order_id Уникальный идентификатор заказа. Type int finished Завершенность автопродления. Type bool

58 Глава 2. Пакет yandex_music Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • expires (str) – Дата истечения подписки. • vendor (str) – Продавец. • vendor_help_url (str) – Ссылка на страницу помощи продавца. • product_id (str) – Уникальный идентификатор продукта. • finished (bool) – Завершенность автопродления. • master_info (yandex_music.User , optional) – Главный в семейной подписке. • product (yandex_music.Product , optional) – Продукт. • order_id (int) – Уникальный идентификатор заказа. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[AutoRenewable] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client ) – Клиент Yandex Music. Результат Информация об автопродлении подписки. Тип результата yandex_music.AutoRenewable classmethod de_list(data: dict, client: Client) → List[AutoRenewable] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация об автопродлении подписки. Тип результата list из yandex_music.AutoRenewable

2.4.8 yandex_music.NonAutoRenewable class yandex_music.NonAutoRenewable(start: str, end: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий отключённое автопродление. start Дата начала подписки.

2.4. Пакет yandex_music.account 59 Yandex Music API

Type str end Дата окончания подписки. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • start (str) – Дата начала подписки. • end (str) – Дата окончания подписки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[NonAutoRenewable] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Отключённое автопродление. Тип результата yandex_music.NonAutoRenewable

2.4.9 yandex_music.Product class yandex_music.Product(product_id: str, type_: str, common_period_duration: str, duration: int, trial_duration: int, price: Optional[Price], feature: str, debug: bool, plus: bool, cheapest: Optional[bool] = None, title: Optional[str] = None, family_sub: Optional[bool] = None, fb_image: Optional[str] = None, fb_name: Optional[str] = None, family: Optional[bool] = None, features: List[str] = None, description: Optional[str] = None, available: Optional[bool] = None, trial_available: Optional[bool] = None, trial_period_duration: Optional[str] = None, intro_period_duration: Optional[str] = None, intro_price: Optional[Price] = None, start_period_duration: Optional[str] = None, start_price: Optional[Price] = None, licence_text_parts: List[Price] = None, vendor_trial_available: Optional[bool] = None, button_text: Optional[str] = None, button_additional_text: Optional[str] = None, payment_method_types: List[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий продаваемый продукт. product_id Уникальный идентификатор. Type str

60 Глава 2. Пакет yandex_music Yandex Music API

type Тип продаваемого. Type str common_period_duration Длительность общего периода. Type str duration Длительность. Type int trial_duration Длительность испытательного срока. Type int price Цена. Type yandex_music.Price feature Предоставляемая возможность. Type str debug Отладочный продукт. Type bool plus Даёт ли подписку «Плюс». Type bool cheapest Самый дешёвый (лучшее предложение). Type bool title Заголовок продукта. Type str family_sub Семейная ли подписка. Type bool fb_image Картинка для превью на facebook. Type str fb_name Заголовок превью на facebook. Type str family Доступно ли для семьи.

2.4. Пакет yandex_music.account 61 Yandex Music API

Type bool features Список предоставляемых возможностей. Type list из str description Описание. Type str available Доступна ли покупка. Type bool trial_available Доступен ли пробный период. Type bool trial_period_duration Длительность пробного периода. Type str intro_period_duration Длительность вступительного периода TODO. Type str intro_price Цена вступительного периода. Type yandex_music.Price start_period_duration Длительность первого срока (за меньшую цену). Type str start_price Цена за первый срок. Type yandex_music.Price licence_text_parts Длительность пробного периода. Type list из yandex_music.LicenceTextPart vendor_trial_available Доступен испытательный срок продавца TODO. Type bool button_text Текст кнопки. Type str button_additional_text Дополнительный текст кнопки. Type str

62 Глава 2. Пакет yandex_music Yandex Music API

payment_method_types Способы оплаты. Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • product_id (str) – Уникальный идентификатор. • type (str) – Тип продаваемого. • common_period_duration (str) – Длительность общего периода. • duration (int) – Длительность. • trial_duration (int) – Длительность испытательного срока. • price (yandex_music.Price ) – Цена. • feature (str) – Предоставляемая возможность. • debug (bool) – Отладочный продукт. • plus (bool) – Даёт ли подписку «Плюс». • cheapest (bool, optional) – Самый дешёвый (лучшее предложение). • title (str, optional) – Заголовок продукта. • family_sub (bool, optional) – Семейная ли подписка. • fb_image (str, optional) – Картинка для превью на facebook. • fb_name (str, optional) – Заголовок превью на facebook. • family (bool, optional) – Доступно ли для семьи. • features (list из str, optional) – Список предоставляемых возможностей. • description (str, optional) – Описание. • available (bool, optional) – Доступна ли покупка. • trial_available (bool, optional) – Доступен ли пробный период. • trial_period_duration (str, optional) – Длительность пробного периода. • intro_period_duration (str, optional) – Длительность вступительного периода TODO. • intro_price (yandex_music.Price , optional) – Цена вступительного периода. • start_period_duration (str, optional) – Длительность первого срока (за мень- шую цену). • start_price (yandex_music.Price , optional) – Цена за первый срок. • licence_text_parts (list из yandex_music.LicenceTextPart , optional) – Дли- тельность пробного периода. • vendor_trial_available (bool, optional) – Доступен испытательный срок про- давца TODO. • button_text (str, optional) – Текст кнопки.

2.4. Пакет yandex_music.account 63 Yandex Music API

• button_additional_text (str, optional) – Дополнительный текст кнопки. • payment_method_types (list из str, optional) – Способы оплаты. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Product] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Продаваемый продукт. Тип результата yandex_music.Product classmethod de_list(data: dict, client: Client) → List[Product] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Продаваемые продукты. Тип результата list из yandex_music.Product

2.4.10 yandex_music.Price class yandex_music.Price(amount: int, currency: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий цену. amount Количество единиц. Type int currency Валюта. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • amount (int) – Количество единиц. • currency (str) – Валюта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

64 Глава 2. Пакет yandex_music Yandex Music API

• **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Price] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Цена. Тип результата yandex_music.Price

2.4.11 yandex_music.Operator class yandex_music.Operator(product_id: str, phone: str, payment_regularity: str, deactivation: List[Deactivation], title: str, suspended: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий услугу сотового оператора. product_id Уникальный идентификатор продукта сервиса Яндекс.Музыка. Type str phone Мобильный номер, на который подключена услуга. Type str payment_regularity Регулярность оплаты. Type str deactivation Способы деактивации. Type list из yandex_music.Deactivation title Название услуги. Type str suspended Приостановлено. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • product_id (str) – Уникальный идентификатор продукта сервиса Ян- декс.Музыка.

2.4. Пакет yandex_music.account 65 Yandex Music API

• phone (str) – Мобильный номер, на который подключена услуга. • payment_regularity (str) – Регулярность оплаты. • deactivation (list из yandex_music.Deactivation ) – Способы деактивации. • title (str) – Название услуги. • suspended (bool) – Приостановлено. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Operator] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Услуга сотового оператора. Тип результата yandex_music.Operator classmethod de_list(data: dict, client: Client) → List[Operator] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Услуги сотового оператора. Тип результата list из yandex_music.Operator

2.4.12 yandex_music.Deactivation class yandex_music.Deactivation(method: str, instructions: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий способы деактивации мобильной услуги.

Примечание: Известные значения поля method: ussd.

method Метод отключения. Type str instructions Инструкция. Type str client Клиент Yandex Music.

66 Глава 2. Пакет yandex_music Yandex Music API

Type yandex_music.Client

Параметры • method (str) – Метод отключения. • instructions (str) – Инструкция. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Deactivation] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Способ отключения услуги. Тип результата yandex_music.Deactivation classmethod de_list(data: dict, client: Client) → List[Deactivation] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Способы отключения услуги. Тип результата list из yandex_music.Deactivation

2.4.13 yandex_music.UserSettings class yandex_music.UserSettings(uid: int, last_fm_scrobbling_enabled: bool, shuffle_enabled: bool, volume_percents: int, modified: str, facebook_scrobbling_enabled: bool, add_new_track_on_playlist_top: bool, user_music_visibility: str, user_social_visibility: str, rbt_disabled: bool, theme: str, promos_disabled: bool, auto_play_radio: bool, sync_queue_enabled: bool, ads_disabled: Optional[bool] = None, disk_enabled: Optional[bool] = None, show_disk_tracks_in_library: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий настройки пользователя.

Примечание: Доступные значения для поля theme: white, black. Доступные значения для полей user_music_visibility и user_social_visibility: private, public.

2.4. Пакет yandex_music.account 67 Yandex Music API

Notes

promos_disabled, ads_disabled, rbt_disabled устарели и не работают. last_fm_scrobbling_enabled, facebook_scrobbling_enabled выглядят устаревшими. uid Уникальный идентификатор пользователя. Type int last_fm_scrobbling_enabled Скробблинг lastfm. Type bool shuffle_enabled Переключать треки в случайном порядке. Type bool volume_percents Громкость звука в процентах. Type int modified Дата изменения настроек. Type str facebook_scrobbling_enabled Скробблинг facebook. Type bool add_new_track_on_playlist_top Добавлять новые треки в начало плейлиста. Type bool user_music_visibility Публичный доступ к моей фонотеке. Type str user_social_visibility Показывать соцсети на странице. Type str rbt_disabled TODO (неиспользуемая фича). Type bool theme Тема оформления. Type str promos_disabled Не показывать рекламируемый контент). Type bool

68 Глава 2. Пакет yandex_music Yandex Music API

auto_play_radio Бесконечный поток музыки. Type bool sync_queue_enabled Синхронизация очередей между устройствами. Type bool ads_disabled Не показывать рекламу. Type bool disk_enabled TODO. Type bool show_disk_tracks_in_library Показывать локальные треки в библиотеке. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • uid (int) – Уникальный идентификатор пользователя. • last_fm_scrobbling_enabled (bool) – Скробблинг lastfm. • shuffle_enabled (bool) – Переключать треки в случайном порядке. • volume_percents (int) – Громкость звука в процентах. • modified (str) – Дата изменения настроек. • facebook_scrobbling_enabled (bool) – Скробблинг facebook. • add_new_track_on_playlist_top (bool) – Добавлять новые треки в начало плейлиста. • user_music_visibility (str) – Публичный доступ к моей фонотеке. • user_social_visibility (str) – Показывать соцсети на странице. • rbt_disabled (bool) – TODO (неиспользуемая фича). • theme (str) – Тема оформления. • promos_disabled (bool) – Не показывать рекламируемый контент). • auto_play_radio (bool) – Бесконечный поток музыки. • sync_queue_enabled (bool) – Синхронизация очередей между устройствами. • ads_disabled (bool, optional) – Не показывать рекламу. • disk_enabled (bool, optional) – TODO. • show_disk_tracks_in_library (bool, optional) – Показывать локальные треки в библиотеке.

2.4. Пакет yandex_music.account 69 Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[UserSettings] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Настройки пользователя. Тип результата yandex_music.UserSettings

2.4.14 yandex_music.Alert class yandex_music.Alert(alert_id: str, text: str, bg_color: str, text_color: str, alert_type: str, button: AlertButton, close_button: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий блок с предупреждением.

Примечание: Данные предупреждения, скорее всего, только обкатываются. У них нет ID, вме- сто этого xxx, а еще присутствуют слова «тест» в тексте. Используют как предупреждение о конце подписки, так и о раздаче подарков.

alert_id Уникальный идентификатор. Type str text Текст предупреждения. Type str bg_color Цвет заднего фона. Type str text_color Цвет текста. Type str alert_type Тип предупреждения. Type str button Кнопка с ссылкой. Type yandex_music.AlertButton

70 Глава 2. Пакет yandex_music Yandex Music API

close_button Наличие кнопки «Закрыть». Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • alert_id (str) – Уникальный идентификатор. • text (str) – Текст предупреждения. • bg_color (str) – Цвет заднего фона. • text_color (str) – Цвет текста. • alert_type (str) – Тип предупреждения. • button (yandex_music.AlertButton ) – Кнопка с ссылкой. • close_button (bool) – Наличие кнопки «Закрыть». • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Alert] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Сообщение о статусе подписки. Тип результата yandex_music.Alert

2.4.15 yandex_music.AlertButton class yandex_music.AlertButton(text: str, bg_color: str, text_color: str, uri: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий кнопку в предупреждении. text Текст кнопки. Type str bg_color Цвет заднего фона. Type str text_color Цвет текста. Type str

2.4. Пакет yandex_music.account 71 Yandex Music API

uri Ссылка куда ведёт кнопка. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • text (str) – Текст кнопки. • bg_color (str) – Цвет заднего фона. • text_color (str) – Цвет текста. • uri (str) – Ссылка куда ведёт кнопка. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[AlertButton] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Кнопка в статусе о подписки. Тип результата yandex_music.AlertButton

72 Глава 2. Пакет yandex_music Yandex Music API

2.5 Пакет yandex_music.album

2.5.1 yandex_music.Album class yandex_music.Album(id_: int, error: Optional[str] = None, title: Optional[str] = None, track_count: Optional[int] = None, artists: List[Artist] = None, labels: List[Union[Label, str]] = None, available: Optional[bool] = None, available_for_premium_users: Optional[bool] = None, version: Optional[str] = None, cover_uri: Optional[str] = None, content_warning: Optional[str] = None, original_release_year=None, genre: Optional[str] = None, text_color: Optional[str] = None, short_description: Optional[str] = None, description: Optional[str] = None, is_premiere: Optional[bool] = None, is_banner: Optional[bool] = None, meta_type: Optional[str] = None, storage_dir: Optional[str] = None, og_image: Optional[str] = None, buy: Optional[list] = None, recent: Optional[bool] = None, very_important: Optional[bool] = None, available_for_mobile: Optional[bool] = None, available_partially: Optional[bool] = None, bests: Optional[List[int]] = None, duplicates: List[Album] = None, prerolls: Optional[list] = None, volumes: Optional[List[List[Track]]] = None, year: Optional[int] = None, release_date: Optional[str] = None, type_: Optional[str] = None, track_position: Optional[TrackPosition] = None, regions=None, available_as_rbt: Optional[bool] = None, lyrics_available: Optional[bool] = None, remember_position: Optional[bool] = None, albums: Optional[List[Album]] = None, duration_ms: Optional[int] = None, explicit: Optional[bool] = None, start_date: Optional[str] = None, likes_count: Optional[int] = None, deprecation: Optional[Deprecation] = None, available_regions: Optional[List[str]] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий альбом.

Примечание: Известные типы альбома: single - сингл, compilation - сборник. Известные предупреждения о содержимом: explicit - ненормативная лексика. Известные ошибки: not-found - альбом с таким ID не существует. Известные значения поля meta_type: music.

id Идентификатор альбома. Type int error Ошибка получения альбома. Type str title Название альбома. Type str

2.5. Пакет yandex_music.album 73 Yandex Music API

track_count Количество треков. Type int artists Артисты. Type list из yandex_music.Artist labels Лейблы. Type list из yandex_music.Label или str available Доступен ли альбом. Type bool available_for_premium_users Доступен ли альбом для пользователей с подпиской. Type bool version Дополнительная информация об альбоме. Type str cover_uri Ссылка на обложку. Type str content_warning Предупреждение о содержимом альбома. Type str genre Жанр музыки. Type str text_color Цвет текста описания. Type str short_description Короткое описание. Type str description Описание. Type str is_premiere Премьера ли. Type bool is_banner Является ли баннером.

74 Глава 2. Пакет yandex_music Yandex Music API

Type bool meta_type Мета тип TODO. Type str storage_dir В какой папке на сервере хранится файл TODO. Type str og_image Ссылка на превью Open Graph. Type str recent Является ли альбом новым. Type bool very_important Популярен ли альбом у слушателей. Type bool available_for_mobile Доступен ли альбом из приложения для телефона. Type bool available_partially Доступен ли альбом частично для пользователей без подписки. Type bool bests ID лучших треков альбома. Type list из int duplicates Альбомы-дубликаты. Type list из yandex_music.Album prerolls Прероллы TODO. Type list volumes Треки альбома, разделённые по дискам. Type list из list из Track year Год релиза. Type int release_date Дата релиза в формате ISO 8601. Type str

2.5. Пакет yandex_music.album 75 Yandex Music API

type Тип альбома. Type str track_position Позиция трека в альбоме. Возвращается при получении альбома в составе трека. Type yandex_music.TrackPosition available_as_rbt TODO. Type bool lyrics_available Доступны ли слова TODO. Type bool remember_position Запоминание позиции TODO. Type bool albums Альбомы TODO. Type list из yandex_music.Album duration_ms Длительность в миллисекундах. Type int explicit Есть ли в треке ненормативная лексика. Type bool start_date Дата начала в формате ISO 8601 TODO. Type str likes_count Количество лайков TODO. Type int deprecation TODO. Type yandex_music.Deprecation available_regions Регионы, где доступн альбом. Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры

76 Глава 2. Пакет yandex_music Yandex Music API

• id (int) – Идентификатор альбома. • error (str, optional) – Ошибка получения альбома. • title (str, optional) – Название альбома. • track_count (int, optional) – Количество треков. • artists (list из yandex_music.Artist , optional) – Артисты. • labels (list из yandex_music.Label или str, optional) – Лейблы. • available (bool, optional) – Доступен ли альбом. • available_for_premium_users (bool, optional) – Доступен ли альбом для поль- зователей с подпиской. • version (str, optional) – Дополнительная информация об альбоме. • cover_uri (str, optional) – Ссылка на обложку. • content_warning (str, optional) – Предупреждение о содержимом альбома. • genre (str, optional) – Жанр музыки. • text_color (str, optional) – Цвет текста описания. • short_description (str, optional) – Короткое описание. • description (str, optional) – Описание. • is_premiere (bool, optional) – Премьера ли. • is_banner (bool, optional) – Является ли баннером. • meta_type (str, optional) – Мета тип TODO. • storage_dir (str, optional) – В какой папке на сервере хранится файл TODO. • og_image (str, optional) – Ссылка на превью Open Graph. • recent (bool, optional) – Является ли альбом новым. • very_important (bool, optional) – Популярен ли альбом у слушателей. • available_for_mobile (bool, optional) – Доступен ли альбом из приложения для телефона. • available_partially (bool, optional) – Доступен ли альбом частично для поль- зователей без подписки. • bests (list из int, optional) – ID лучших треков альбома. • duplicates (list из yandex_music.Album , optional) – Альбомы-дубликаты. • prerolls (list, optional) – Прероллы TODO. • volumes (list из list из Track , optional) – Треки альбома, разделённые по дискам. • year (int, optional) – Год релиза. • release_date (str, optional) – Дата релиза в формате ISO 8601. • type (str, optional) – Тип альбома. • track_position (yandex_music.TrackPosition , optional) – Позиция трека в альбоме. Возвращается при получении альбома в составе трека. • available_as_rbt (bool, optional) – TODO.

2.5. Пакет yandex_music.album 77 Yandex Music API

• lyrics_available (bool, optional) – Доступны ли слова TODO. • remember_position (bool, optional) – Запоминание позиции TODO. • albums (list из yandex_music.Album , optional) – Альбомы TODO. • duration_ms (int, optional) – Длительность в миллисекундах. • explicit (bool, optional) – Есть ли в треке ненормативная лексика. • start_date (str, optional) – Дата начала в формате ISO 8601 TODO. • likes_count (int, optional) – Количество лайков TODO. • deprecation (yandex_music.Deprecation , optional) – TODO. • available_regions (list из str, optional) – Регионы, где доступн альбом. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Album] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Альбом. Тип результата yandex_music.Album classmethod de_list(data: dict, client: Client) → List[Album] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Альбомы. Тип результата list из yandex_music.Album dislike(*args, **kwargs) → bool Сокращение для: client.users_likes_albums_remove(album.id, user.id *args, **kwargs) downloadCover(filename: str, size: str = ’200x200’) → None Псевдоним для download_cover downloadOgImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_og_image download_cover(filename: str, size: str = ’200x200’) → None Загрузка обложки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки.

78 Глава 2. Пакет yandex_music Yandex Music API

download_og_image(filename: str, size: str = ’200x200’) → None Загрузка обложки. Предпочтительнее использовать self.download_cover(). Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. like(*args, **kwargs) → bool Сокращение для: client.users_likes_albums_add(album.id, user.id *args, **kwargs) withTracks(*args, **kwargs) → Optional[yandex_music.album.album.Album] Псевдоним для with_tracks with_tracks(*args, **kwargs) → Optional[yandex_music.album.album.Album] Сокращение для: client.albums_with_tracks(album.id, *args, **kwargs)

2.5.2 yandex_music.TrackPosition class yandex_music.TrackPosition(volume: int, index: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий позицию трека. None: Позиция трека в альбоме, который возвращается при получении самого трека. Volume на фронте именуется как «Диск». volume Номер альбома. Type int index Порядковый номер трека. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • volume (int) – Номер альбома. • index (int) – Порядковый номер трека. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TrackPosition] Десериализация объекта.

2.5. Пакет yandex_music.album 79 Yandex Music API

Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Позиция трека. Тип результата yandex_music.TrackPosition

2.5.3 yandex_music.Label class yandex_music.Label(id_: int, name: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий лейбл альбома. id Идентификатор альбома. Type int name Название альбома. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int) – Идентификатор альбома. • name (str) – Название альбома. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Label] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Лейбл. Тип результата yandex_music.Label classmethod de_list(data: dict, client: Client) → List[Union[Label, str]] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

80 Глава 2. Пакет yandex_music Yandex Music API

Примечание: Лейблы строками возвращаются, как минимум, в результатах поиска. В остальных местах это объекты.

Результат Лейблы. Тип результата list из yandex_music.Label или str

2.5.4 yandex_music.Deprecation class yandex_music.Deprecation(target_album_id: Optional[int], status: Optional[str], done: Optional[bool], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий TODO. target_album_id Идентификатор альбома TODO. Type int status Состояние TODO. Type str done Выполнен ли TODO. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • target_album_id (int) – Идентификатор альбома TODO. • status (str) – Состояние TODO. • done (str) – Выполнен ли TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Deprecation] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат TODO. Тип результата yandex_music.Deprecation

2.5. Пакет yandex_music.album 81 Yandex Music API

2.6 Пакет yandex_music.artist

2.6.1 yandex_music.Counts class yandex_music.Counts(tracks: int, direct_albums: int, also_albums: int, also_tracks: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий счётчик некоторых значений исполнителя.

Примечание: Под дополнительными подразумеваются треки и альбомы, в которых артист задействован, но не является его автором. Так же в дополнительные альбомы входят сборники.

tracks Количество треков. Type int direct_albums Количество альбомов. Type int also_albums Количество дополнительных треков. Type int also_tracks Количество дополнительных альбомов. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • tracks (int) – Количество треков. • direct_albums (int) – Количество альбомов. • also_albums (int) – Количество дополнительных треков. • also_tracks (int) – Количество дополнительных альбомов. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Counts] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Cчётчик некоторых значений исполнителя.

82 Глава 2. Пакет yandex_music Yandex Music API

Тип результата yandex_music.Counts

2.6.2 yandex_music.Link class yandex_music.Link(title: str, href: str, type_: str, social_network: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий ссылку на официальную страницу исполнителя.

Примечание: Известные типы страниц: official - официальный сайт и social - социальная сеть.

title Название страницы. Type str href URL страницы. Type str type_ Тип страницы. Type str social_network Название социальной сети. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Название страницы. • href (str) – URL страницы. • type (str) – Тип страницы. • social_network (str, optional) – Название социальной сети. • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[Link] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ссылка на официальную страницу исполнителя. Тип результата yandex_music.Link

2.6. Пакет yandex_music.artist 83 Yandex Music API

classmethod de_list(data: dict, client: Client) → List[Link] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ссылки на официальные страницы исполнителя. Тип результата list из yandex_music.Link

2.6.3 yandex_music.Artist class yandex_music.Artist(id_: int, error: Optional[str] = None, reason: Optional[str] = None, name: Optional[str] = None, cover: Optional[Cover] = None, various: Optional[bool] = None, composer: Optional[bool] = None, genres: Optional[List[str]] = None, og_image: Optional[str] = None, op_image: Optional[str] = None, no_pictures_from_search=None, counts: Optional[Counts] = None, available: Optional[bool] = None, ratings: Optional[Ratings] = None, links: Optional[List[Link]] = None, tickets_available: Optional[bool] = None, likes_count: Optional[int] = None, popular_tracks: Optional[List[Track]] = None, regions: Optional[List[str]] = None, decomposed: Optional[List[Union[str, Artist]]] = None, full_names=None, hand_made_description: Optional[str] = None, description: Optional[Description] = None, countries: Optional[List[str]] = None, en_wikipedia_link: Optional[str] = None, db_aliases: Optional[List[str]] = None, aliases=None, init_date: Optional[str] = None, end_date: Optional[str] = None, ya_money_id: Optional[str] = None, client: Client = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий исполнителя. id Уникальный идентификатор. Type int error Сообщение об ошибке с объяснением почему не вернуло исполнителя. Type str reason Причина отсутствия исполнителя (сообщение об ошибке). Type str name Название. Type str cover Обложка. Type yandex_music.Cover | None

84 Глава 2. Пакет yandex_music Yandex Music API

various TODO. Type bool composer TODO. Type bool genres Жанры. Type list из str og_image Ссылка на изображение для Open Graph. Type str, optional op_image Ссылка на изображение обложки. Используется когда не указано поле cover. Type str no_pictures_from_search TODO. counts Счётчики. Type yandex_music.Counts | None available Доступен ли для прослушивания. Type bool ratings Рейтинги. Type yandex_music.Ratings | None links Ссылки на ресурсы исполнителя. Type list из yandex_music.Link tickets_available Имеются ли в продаже билеты на концерт. Type bool regions Регион TODO. Type list из str decomposed Декомпозиция всех исполнителей. Лист, где чередуется разделитель и артист. Фиты и прочее. Type list из str и yandex_music.Artist popular_tracks Популярные треки. Type list yandex_music.Track

2.6. Пакет yandex_music.artist 85 Yandex Music API

likes_count Количество лайков. Type int full_names TODO. hand_made_description Описание от Яндекс TODO. Type str description Описание. Type yandex_music.Description | None countries Страны. Type list из str en_wikipedia_link Адрес страницы на wikipedia.org. Type str db_aliases Другие названия. Как правило названия на разных языках. Type list из str aliases TODO. init_date Дата начала в формате YYYY-MM-DD или YYYY. Type str end_date Дата окончания в формате YYYY-MM-DD или YYYY. Type str ya_money_id Номер кошеляка Яндекс.Деньги TODO. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int) – Уникальный идентификатор. • error (str, optional) – Сообщение об ошибке с объяснением почему не вернуло исполнителя. • reason (str, optional) – Причина отсутствия исполнителя (сообщение об ошиб- ке).

86 Глава 2. Пакет yandex_music Yandex Music API

• name (str, optional) – Название. • cover (yandex_music.Cover , optional) – Обложка. • various (bool, optional) – TODO. • composer (bool, optional) – TODO. • genres (list из str, optional) – Жанры. • og_image (str, optional) – Ссылка на изображение для Open Graph. • op_image (str, optional) – Ссылка на изображение обложки. Используется когда не указано поле cover. • no_pictures_from_search – TODO. • counts (yandex_music.Counts , optional) – Счётчики. • available (bool, optional) – Доступен ли для прослушивания. • ratings (yandex_music.Ratings , optional) – Рейтинги. • links (list из yandex_music.Link , optional) – Ссылки на ресурсы исполнителя. • tickets_available (bool, optional) – Имеются ли в продаже билеты на концерт. • likes_count (int, optional) – Количество лайков. • popular_tracks (list yandex_music.Track , optional) – Популярные треки. • regions (list из str, optional) – Регион TODO. • decomposed (list из str и yandex_music.Artist , optional) – Декомпозиция всех исполнителей. Лист, где чередуется разделитель и артист. Фиты и прочее. • full_names – TODO. • hand_made_description (str, optional) – Описание от Яндекс TODO. • description (yandex_music.Description , optional) – Описание. • countries (list из str, optional) – Страны. • en_wikipedia_link (str, optional) – Адрес страницы на wikipedia.org. • db_aliases (list из str, optional) – Другие названия. Как правило названия на разных языках. • aliases – TODO. • init_date (str, optional) – Дата начала в формате YYYY-MM-DD или YYYY. • end_date (str, optional) – Дата окончания в формате YYYY-MM-DD или YYYY. • ya_money_id (str) – Номер кошеляка Яндекс.Деньги TODO. • client (yandex_music.Client ) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Artist] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта.

2.6. Пакет yandex_music.artist 87 Yandex Music API

• client (yandex_music.Client ) – Клиент Yandex Music. Результат Исполнитель. Тип результата yandex_music.Artist classmethod de_list(data: dict, client: Client) → List[Artist] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client ) – Клиент Yandex Music. Результат Исполнители. Тип результата list из yandex_music.Artist dislike(*args, **kwargs) → bool Сокращение для: client.users_likes_artists_remove(artist.id, user.id *args, **kwargs) downloadOgImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_og_image downloadOpImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_op_image download_og_image(filename: str, size: str = ’200x200’) → None Загрузка изображения для Open Graph. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. download_op_image(filename: str, size: str = ’200x200’) → None Загрузка обложки.

Notes

Используйте это только когда нет self.cover! Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. getAlbums(page=0, page_size=20, sort_by=’year’, *args, **kwargs) → Optional[ArtistAlbums] Псевдоним для get_albums getTracks(page=0, page_size=20, *args, **kwargs) → Optional[ArtistTracks] Псевдоним для get_tracks get_albums(page=0, page_size=20, sort_by=’year’, *args, **kwargs) → Optional[ArtistAlbums] Сокращение для: client.artists_direct_albums(artist.id, page, page_size, sort_by, *args, **kwargs)

88 Глава 2. Пакет yandex_music Yandex Music API

get_tracks(page=0, page_size=20, *args, **kwargs) → Optional[ArtistTracks] Сокращение для: client.artists_tracks(artist.id, page, page_size, *args, **kwargs) like(*args, **kwargs) → bool Сокращение для: client.users_likes_artists_add(artist.id, user.id *args, **kwargs)

2.6.4 yandex_music.Ratings class yandex_music.Ratings(month: int, week: Optional[int] = None, day: Optional[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий рейтинг исполнителя. month Значение ежемесячного рейтинга. Type int week Значение еженедельного рейтинга. Type int day Значение дневного рейтинга. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • month (int) – Значение ежемесячного рейтинга. • week (int, optional) – Значение еженедельного рейтинга. • day (int, optional) – Значение дневного рейтинга. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Ratings] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Рейтинг исполнителя. Тип результата yandex_music.Ratings

2.6. Пакет yandex_music.artist 89 Yandex Music API

2.6.5 yandex_music.Vinyl class yandex_music.Vinyl(url: str, title: str, year: int, price: int, media: str, offer_id: int, artist_ids: List[int], picture: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий виниловую пластинку. url Ссылка на пластинку в магазине. Type str title Заголовок. Type str year Год выпуска. Type int price Цена. Type int media Средство распространения. Type str offer_id Уникальный идентификатор предложения. Type int artist_ids Перечень уникальный идентификаторов исполнителей. Type list из int picture Ссылка на обложку. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • url (str) – Ссылка на пластинку в магазине. • title (str) – Заголовок. • year (int) – Год выпуска. • price (int) – Цена. • media (str) – Средство распространения.

90 Глава 2. Пакет yandex_music Yandex Music API

• offer_id (int) – Уникальный идентификатор предложения. • artist_ids (list из int) – Перечень уникальный идентификаторов исполните- лей. • picture (str, optional) – Ссылка на обложку. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Vinyl] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ваниловая пластинка. Тип результата yandex_music.Vinyl classmethod de_list(data: dict, client: Client) → List[Vinyl] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ваниловые пластинки. Тип результата list из yandex_music.Vinyl

2.6.6 yandex_music.Description class yandex_music.Description(text: str, uri: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий описание исполнителя из другого источника.

Примечание: Очень редкий объект, у минимального количества исполнителей. Обычно берётся информация из википедии.

text Описание исполнителя. Type str uri Ссылка на источник. Type str client Клиент Yandex Music. Type yandex_music.Client

2.6. Пакет yandex_music.artist 91 Yandex Music API

Параметры • text (str) – Описание исполнителя. • uri (str) – Ссылка на источник. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Description] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Описание исполнителя из другого источника. Тип результата yandex_music.Description

2.6.7 yandex_music.BriefInfo class yandex_music.BriefInfo(artist: Optional[Artist], albums: List[Album], playlists: List[Playlist], also_albums: List[Album], last_release_ids: List[int], last_releases: List[Album], popular_tracks: List[Track], similar_artists: List[Artist], all_covers: List[Cover], concerts, videos: List[Video], vinyls: List[Vinyl], has_promotions: bool, playlist_ids: List[PlaylistId], tracks_in_chart: List[Chart] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию об артисте. artist Артист. Type yandex_music.Artist | None albums Альбомы. Type list из yandex_music.Album playlists Плейлисты. Type list из yandex_music.Playlist also_albums Сборники. Type list из yandex_music.Album last_release_ids Уникальные идентификаторы последних выпущенных альбомов. Type list из int last_releases Последние выпущенные альбомы.

92 Глава 2. Пакет yandex_music Yandex Music API

Type list из yandex_music.Album popular_tracks Популярные треки. Type list из yandex_music.Track similar_artists Похожие артисты. Type list из yandex_music.Artist all_covers Все обложки. Type list из yandex_music.Cover concerts Концерты (тест-кейс с ними потерялся, мало у кого есть). Type str videos Видео. Type list из yandex_music.Video vinyls Пластинки. Type list из yandex_music.Vinyl has_promotions Рекламируется ли TODO. Type bool playlist_ids Уникальные идентификаторы плейлистов. Type list из yandex_music.PlaylistId tracks_in_chart Треки в чарте. Type list из yandex_music.Chart client Клиент Yandex Music. Type yandex_music.Client

Параметры • artist (yandex_music.Artist | None) – Артист. • albums (list из yandex_music.Album ) – Альбомы. • playlists (list из yandex_music.Playlist ) – Плейлисты. • also_albums (list из yandex_music.Album ) – Сборники. • last_release_ids (list из int) – Уникальные идентификаторы последних вы- пущенных альбомов. • last_releases (list из yandex_music.Album , optional) – Последние выпущен- ные альбомы.

2.6. Пакет yandex_music.artist 93 Yandex Music API

• popular_tracks (list из yandex_music.Track ) – Популярные треки. • similar_artists (list из yandex_music.Artist ) – Похожие артисты. • all_covers (list из yandex_music.Cover ) – Все обложки. • concerts (str) – Концерты (тест-кейс с ними потерялся, мало у кого есть). • videos (list из yandex_music.Video ) – Видео. • vinyls (list из yandex_music.Vinyl ) – Пластинки. • has_promotions (bool) – Рекламируется ли TODO. • playlist_ids (list из yandex_music.PlaylistId ) – Уникальные идентифика- торы плейлистов. • tracks_in_chart (list из yandex_music.Chart , optional) – Треки в чарте. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[BriefInfo] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация об артисте. Тип результата yandex_music.BriefInfo

2.6.8 yandex_music.ArtistTracks class yandex_music.ArtistTracks(tracks: List[Track], pager: Optional[Pager], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий страницу списка треков артиста. tracks Список треков артиста. Type list из yandex_music.Track pager Пагинатор. Type yandex_music.Pager client Клиент Yandex Music. Type yandex_music.Client

Параметры • tracks (list из yandex_music.Track ) – Список треков артиста. • pager (yandex_music.Pager ) – Пагинатор.

94 Глава 2. Пакет yandex_music Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ArtistTracks] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Страница списка треков артиста. Тип результата yandex_music.ArtistsTracks

2.6.9 yandex_music.ArtistAlbums class yandex_music.ArtistAlbums(albums: List[Album], pager: Optional[Pager], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий страницу списка альбомов артиста. albums Список альбомов артиста. Type list из yandex_music.Album pager Пагинатор. Type yandex_music.Pager client Клиент Yandex Music. Type yandex_music.Client

Параметры • albums (list из yandex_music.Album ) – Список альбомов артиста. • pager (yandex_music.Pager ) – Пагинатор. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ArtistAlbums] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Список альбомов артиста. Тип результата yandex_music.ArtistAlbums

2.6. Пакет yandex_music.artist 95 Yandex Music API

2.7 Пакет yandex_music.feed

2.7.1 yandex_music.Feed class yandex_music.Feed(can_get_more_events: bool, pumpkin: bool, is_wizard_passed: bool, generated_playlists: List[GeneratedPlaylist], headlines: list, today: str, days: List[Day], next_revision: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий фид.

Примечание: Несмотря на то, что days это list, обычно возвращается только один день - текущий.

can_get_more_events Можно ли получить больше событий. Type bool pumpkin Хэллоуин. Type bool is_wizard_passed TODO. Type bool generated_playlists Сгенерированные плейлисты. Type list из yandex_music.GeneratedPlaylist headlines Заголовки. Type list из str today Сегодняшняя дата в формате YYYY-MM-DD. Type str days Дни. Type list из yandex_music.Day next_revision Дата следующих изменений в формате YYYY-MM-DD. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры

96 Глава 2. Пакет yandex_music Yandex Music API

• can_get_more_events (bool) – Можно ли получить больше событий. • pumpkin (bool) – Хэллоуин. • is_wizard_passed (bool) – TODO. • generated_playlists (list из yandex_music.GeneratedPlaylist ) – Сгенери- рованные плейлисты. • headlines (list из str) – Заголовки. • today (str) – Сегодняшняя дата в формате YYYY-MM-DD. • days (list из yandex_music.Day ) – Дни. • next_revision (str, optional) – Дата следующих изменений в формате YYYY- MM-DD. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Feed] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Фид. Тип результата yandex_music.Feed

2.7.2 yandex_music.TrackWithAds class yandex_music.TrackWithAds(type_: str, track: Optional[Track], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий трек с рекламой.

Примечание: Поле type встречалось только с значением track.

type Тип TODO. Type str track Трек. Type yandex_music.Track client Клиент Yandex Music. Type yandex_music.Client

Параметры

2.7. Пакет yandex_music.feed 97 Yandex Music API

• type (str) – Тип TODO. • track (yandex_music.Track ) – Трек. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TrackWithAds] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Трек с рекламой. Тип результата yandex_music.TrackWithAds classmethod de_list(data: dict, client: Client) → List[TrackWithAds] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Треки с рекламой. Тип результата list из yandex_music.TrackWithAds

2.7.3 yandex_music.GeneratedPlaylist class yandex_music.GeneratedPlaylist(type_: str, ready: bool, notify: bool, data: Optional[Playlist], description: Optional[list] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий автоматически сгенерированный плейлист.

Примечание: Известные значения type: playlistOfTheDay, origin, recentTracks, neverHeard, podcasts, missedLikes.

type Тип сгенерированного плейлиста. Type str ready Готовность плейлиста. Type bool notify Уведомлён ли пользователь об обновлении содержания. Type bool

98 Глава 2. Пакет yandex_music Yandex Music API

data Сгенерированный плейлист. Type yandex_music.Playlist description Описание TODO. Type list client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип сгенерированного плейлиста. • ready (bool) – Готовность плейлиста. • notify (bool) – Уведомлён ли пользователь об обновлении содержания. • data (yandex_music.Playlist , optional) – Сгенерированный плейлист. • description (list, optional) – Описание TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[GeneratedPlaylist] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Автоматически сгенерированный плейлист. Тип результата yandex_music.GeneratedPlaylist classmethod de_list(data: dict, client: Client) → List[GeneratedPlaylist] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Автоматически сгенерированные плейлисты. Тип результата list из yandex_music.GeneratedPlaylist

2.7.4 yandex_music.AlbumEvent class yandex_music.AlbumEvent(album: Optional[Album], tracks: List[Track], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий альбом в событии фида.

2.7. Пакет yandex_music.feed 99 Yandex Music API

album Альбом. Type yandex_music.Album | None tracks Треки. Type list из yandex_music.Track client Клиент Yandex Music. Type yandex_music.Client

Параметры • album (yandex_music.Album | None) – Альбом. • tracks (list из yandex_music.Track ) – Треки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[AlbumEvent] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Альбом в событии фида. Тип результата yandex_music.AlbumEvent classmethod de_list(data: dict, client: Client) → List[AlbumEvent] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Альбомы в событии фида. Тип результата list из yandex_music.AlbumEvent

2.7.5 yandex_music.ArtistEvent class yandex_music.ArtistEvent(artist: Optional[Artist], tracks: List[Track], similar_to_artists_from_history: List[Artist], subscribed: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий артиста в событии фида. artist Артист.

100 Глава 2. Пакет yandex_music Yandex Music API

Type yandex_music.Artist | None tracks Треки. Type list yandex_music.Track similar_to_artists_from_history Похожие артисты из истории. Type list yandex_music.Artist subscribed Подписан ли на событие. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • artist (yandex_music.Artist | None) – Артист. • tracks (list yandex_music.Track ) – Треки. • similar_to_artists_from_history (list yandex_music.Artist ) – Похожие ар- тисты из истории. • subscribed (bool) – Подписан ли на событие. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ArtistEvent] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Артист из события фида. Тип результата yandex_music.ArtistEvent classmethod de_list(data: dict, client: Client) → List[ArtistEvent] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Артисты из события фида. Тип результата list из yandex_music.ArtistEvent

2.7. Пакет yandex_music.feed 101 Yandex Music API

2.7.6 yandex_music.Event class yandex_music.Event(id_: str, type_: str, type_for_from: Optional[str] = None, title: Optional[str] = None, tracks: List[Track] = None, artists: List[ArtistEvent] = None, albums: List[AlbumEvent] = None, message=None, device=None, tracks_count: Optional[int] = None, genre: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий событие фида.

Примечание: Известные значения поля type_: tracks, artists, albums, notification. Поле message заполнено только когда type равен notification. Примером значения поля type_for_from может служить recommended-similar-artists. Наличие данных в tracks, albums, artists напрямую зависит от type_.

id_ Уникальный идентификатор события. Type str type_ Тип события. Type str type_for_from Откуда пришло событие. Type str title Заголовок. Type str tracks Список треков. Type list из yandex_music.Track artists Список артистов с похожими и популярными треками. Type list из yandex_music.ArtistEvent albums Список альбомов с треками. Type list из yandex_music.AlbumEvent message Сообщение уведомления. Type str device Устройство, с которого пришло уведомление. Type str

102 Глава 2. Пакет yandex_music Yandex Music API

tracks_count Количество треков (возможно, уже не используется). Type int genre Жанр треков. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор события. • type (str) – Тип события. • type_for_from (str, optional) – Откуда пришло событие. • title (str, optional) – Заголовок. • tracks (list из yandex_music.Track , optional) – Список треков. • artists (list из yandex_music.ArtistEvent , optional) – Список артистов с по- хожими и популярными треками. • albums (list из yandex_music.AlbumEvent , optional) – Список альбомов с тре- ками. • message (str, optional) – Сообщение уведомления. • device (str, optional) – Устройство, с которого пришло уведомление. • tracks_count (int, optional) – Количество треков (возможно, уже не использу- ется). • genre (str, optional) – Жанр треков. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Event] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Событие фида. Тип результата yandex_music.Event classmethod de_list(data: dict, client: Client) → List[Event] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта.

2.7. Пакет yandex_music.feed 103 Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. Результат События фида. Тип результата list из yandex_music.Event

2.7.7 yandex_music.Day class yandex_music.Day(day: str, events: List[Event], tracks_to_play_with_ads: List[TrackWithAds], tracks_to_play: List[Track], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий день в фиде. day Дата в формате YYYY-MM-DD. Type str events События TODO. Type list из yandex_music.Event tracks_to_play_with_ads Треки для проигрывания с рекламой. Type list из yandex_music.TrackWithAds tracks_to_play Треки для проигрывания. Type list из yandex_music.Track client Клиент Yandex Music. Type yandex_music.Client

Параметры • day (str) – Дата в формате YYYY-MM-DD. • events (list из yandex_music.Event ) – События TODO. • tracks_to_play_with_ads (list из yandex_music.TrackWithAds ) – Треки для проигрывания с рекламой. • tracks_to_play (list из yandex_music.Track ) – Треки для проигрывания. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Day] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

104 Глава 2. Пакет yandex_music Yandex Music API

Результат День в фиде. Тип результата yandex_music.Day classmethod de_list(data: dict, client: Client) → List[Day] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Дни в фиде. Тип результата list из yandex_music.Day

2.8 Пакет yandex_music.genre

2.8.1 yandex_music.Images class yandex_music.Images(_208x208: Optional[str] = None, _300x300: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий изображение жанра. _208x208 Ссылка на изображение размером 208 на 208. Type str _300x300 Ссылка на изображение размером 300 на 300. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • _208x208 (str, optional) – Ссылка на изображение размером 208 на 208. • _300x300 (str, optional) – Ссылка на изображение размером 300 на 300. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Images] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Изображение жанра.

2.8. Пакет yandex_music.genre 105 Yandex Music API

Тип результата yandex_music.Images download_208x208(filename: str) → None Загрузка изображения 208x208. Параметры filename (str) – Путь для сохранения файла с названием и расшире- нием. download_300x300(filename: str) → None Загрузка изображения 300x300. Параметры filename (str) – Путь для сохранения файла с названием и расшире- нием.

2.8.2 yandex_music.Genre class yandex_music.Genre(id_: str, weight: int, composer_top: bool, title: str, titles: Dict[str, Optional[Title]], images: Optional[Images], show_in_menu: bool, show_in_regions: Optional[list] = None, full_title: Optional[str] = None, url_part: Optional[str] = None, color: Optional[str] = None, radio_icon: Optional[Icon] = None, sub_genres: List[Genre] = None, hide_in_regions=None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий жанр музыки. id Уникальный идентификатор жанра. Type str weight Вес TODO (возможно, чем выше показатель, тем больше нравится пользователю). Type int composer_top TODO. Type bool title Заголовок жанра. Type str titles Словарь заголовков на разных языках, где ключ - язык. Type dict images Изображение жанра. Type yandex_music.Images show_in_menu Показывать в меню. Type bool show_in_regions Список регионов в которых отображается жанр в списках.

106 Глава 2. Пакет yandex_music Yandex Music API

Type list из int full_title Полный заголовок. Type str url_part Часть ссылки на жанр для открытия в браузере. Type str color Цвет фона изображения. Type str radio_icon Иконка радио жанра. Type yandex_music.Icon sub_genres Поджанры текущего жанра музыки. Type list из yandex_music.Genre hide_in_regions В каких регионах скрывать жанр. Type list client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор жанра. • weight (int) – Вес TODO (возможно, чем выше показатель, тем больше нра- вится пользователю). • composer_top (bool) – TODO. • title (str) – Заголовок жанра. • titles (dict) – Словарь заголовков на разных языках, где ключ - язык. • images (yandex_music.Images ) – Изображение жанра. • show_in_menu (bool) – Показывать в меню. • show_in_regions (list из int, optional) – Список регионов в которых отобра- жается жанр в списках. • full_title (str, optional) – Полный заголовок. • url_part (str, optional) – Часть ссылки на жанр для открытия в браузере. • color (str, optional) – Цвет фона изображения. • radio_icon (yandex_music.Icon , optional) – Иконка радио жанра. • sub_genres (list из yandex_music.Genre , optional) – Поджанры текущего жан- ра музыки.

2.8. Пакет yandex_music.genre 107 Yandex Music API

• hide_in_regions (list, optional) – В каких регионах скрывать жанр. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Genre] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Жанр музыки. Тип результата yandex_music.Genre classmethod de_list(data: dict, client: Client) → List[Genre] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Жанры музыки. Тип результата list из yandex_music.Genre

2.8.3 yandex_music.Title class yandex_music.Title(title: str, full_title: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий заголовок жанра. title Заголовок. Type str full_title Полный заголовок. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Заголовок. • full_title (str, optional) – Полный заголовок. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

108 Глава 2. Пакет yandex_music Yandex Music API

classmethod de_dict(data, client) → Dict[str, Optional[yandex_music.genre.title.Title]] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Заголовки жанров. Тип результата list из yandex_music.Title classmethod de_json(data: dict, client: Client) → Optional[Title] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Заголовок жанра. Тип результата yandex_music.Title

2.9 Пакет yandex_music.landing

2.9.1 yandex_music.BlockEntity class yandex_music.BlockEntity(id_: str, type_: str, data: Union[GeneratedPlaylist, Promotion, Album, Playlist, ChartItem, PlayContext, MixLink, None], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий содержимое блока.

Примечание: В зависимости от поля type_, в поле data будет объект соответствующего типа. Известные значения поля type_: personal-playlist, promotion, album, playlist, chart-item, play-context, mix-link.

id_ Уникальный идентификатор содержимого. Type str type_ Тип содержимого. Type str data (:obj:`yandex_music.GeneratedPlaylist` | :obj:`yandex_music.Promotion` | :obj:`yandex_music.Album` | yandex_music.Playlist | yandex_music.ChartItem | yandex_music.PlayContext | yandex_music.MixLink ): Содержимое. client Клиент Yandex Music.

2.9. Пакет yandex_music.landing 109 Yandex Music API

Type yandex_music.Client

Параметры • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[BlockEntity] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Сущность (объект) блока. Тип результата yandex_music.BlockEntity classmethod de_list(data: dict, client: Client) → List[BlockEntity] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Содержимое блока. Тип результата list из yandex_music.BlockEntity

2.9.2 yandex_music.PlayContextsData class yandex_music.PlayContextsData(other_tracks: List[TrackShortOld], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий данные проигрываемого контекста. other_tracks Другие треки. Type list из yandex_music.TrackShortOld client Клиент Yandex Music. Type yandex_music.Client

Параметры • other_tracks (list из yandex_music.TrackShortOld ) – Другие треки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PlayContextsData] Десериализация объекта.

110 Глава 2. Пакет yandex_music Yandex Music API

Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Данные проигрываемого контекста. Тип результата yandex_music.PlayContextsData

2.9.3 yandex_music.Chart class yandex_music.Chart(position: int, progress: str, listeners: int, shift: int, bg_color: Optional[str] = None, track_id: Optional[TrackId] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий элемент чарта.

Примечание: Смещение - это количество позиций, на которые трек поднялся или опустился в чарте.

position Позиция. Type int progress TODO. Type str listeners Количество слушателей. Type int shift Смещение. Type int bg_color Цвет заднего фона. Type str track_id Уникальный идентификатор трека. Type yandex_music.TrackId | None client Клиент Yandex Music. Type yandex_music.Client

Параметры • position (int) – Позиция. • progress (str) – TODO.

2.9. Пакет yandex_music.landing 111 Yandex Music API

• listeners (int) – Количество слушателей. • shift (int) – Смещение. • bg_color (str, optional) – Цвет заднего фона. • track_id (yandex_music.TrackId , optional) – Уникальный идентификатор тре- ка. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Chart] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Элемент чарта. Тип результата yandex_music.Chart classmethod de_list(data: dict, client: Client) → List[Chart] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Чарт. Тип результата list из yandex_music.Chart

2.9.4 yandex_music.TrackShortOld class yandex_music.TrackShortOld(track_id: Optional[TrackId], timestamp: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий сокращённую версию трека.

Примечание: Данная версия менее богата полями и найдена позже первой, поэтому была при- нята как за старую версию. Другая версия сокращённого трека: yandex_music.TrackShort .

track_id Уникальный идентификатор трека. Type yandex_music.TrackId | None timestamp Дата TODO. Type str

112 Глава 2. Пакет yandex_music Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • track_id (yandex_music.TrackId ) – Уникальный идентификатор трека. • timestamp (str) – Дата TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TrackShortOld] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Сокращённая версия трека или None. Тип результата yandex_music.TrackShortOld classmethod de_list(data: dict, client: Client) → List[TrackShortOld] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Сокращённые версии треков. Тип результата list из yandex_music.TrackShortOld

2.9.5 yandex_music.Landing class yandex_music.Landing(pumpkin: bool, content_id: Union[str, int], blocks: List[Block], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий лендинг. pumpkin Хэллоуин. Type bool content_id Уникальный идентификатор контента. Type str | int blocks Блоки лендинга. Type list из yandex_music.Block

2.9. Пакет yandex_music.landing 113 Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • pumpkin (bool) – Хэллоуин. • content_id (str | int) – Уникальный идентификатор контента. • blocks (list из yandex_music.Block ) – Блоки лендинга. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Landing] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Лендинг. Тип результата yandex_music.Landing

2.9.6 yandex_music.ChartItem class yandex_music.ChartItem(track: Optional[Track], chart: Optional[Chart], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий трек в чарте. track Трек. Type yandex_music.Track | None chart Элемент чарта. Type yandex_music.Chart | None client Клиент Yandex Music. Type yandex_music.Client

Параметры • track (yandex_music.Track | None) – Трек. • chart (yandex_music.Chart | None) – Элемент чарт. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

114 Глава 2. Пакет yandex_music Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[ChartItem] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Трек в чарте. Тип результата yandex_music.ChartItem classmethod de_list(data: dict, client: Client) → List[ChartItem] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Треки в чартах. Тип результата list из yandex_music.ChartItem

2.9.7 yandex_music.PlayContext class yandex_music.PlayContext(client_: str, context: str, context_item: str, tracks: List[TrackShortOld], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий проигрываемый контекст.

Примечание: Известные значения поля client_: android. Поле context хранит в себе место воспроизведения, например, playlist. Поле context_item хранит в себе уникальный идентификатор context’a, т.е. в нашем случае playlist’a.

client_ Клиент. Type str context Тип контекста. Type str context_item Предмет контекста. Type str tracks Треки. Type list из yandex_music.TrackShortOld

2.9. Пакет yandex_music.landing 115 Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • client (yandex_music.Client , optional) – Клиент. • context (str) – Тип контекста. • context_item (str) – Предмет контекста. • tracks (list из yandex_music.TrackShortOld ) – Треки. • client – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PlayContext] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Проигрываемый контекст. Тип результата yandex_music.PlayContext

2.9.8 yandex_music.MixLink class yandex_music.MixLink(title: str, url: str, url_scheme: str, text_color: str, background_color: str, background_image_uri: str, cover_white: str, cover_uri: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий ссылку (кликабельный блок) на подборку.

Примечание: В цветах может как оказаться HEX (#6c65a9 ), так и какой-нибудь transparent. Ссылка со схемой отличается от просто ссылки наличием yandexmusic:// в начале.

title Заголовок ссылки. Type str url Ссылка на подборку. Type str url_scheme Ссылка со схемой на подборку. Type str text_color Цвет текста (HEX).

116 Глава 2. Пакет yandex_music Yandex Music API

Type str background_color Цвет заднего фона. Type str background_image_uri Ссылка на изображение заднего фона. Type str cover_white Ссылка на изображение с обложкой TODO. Type str cover_uri Ссылка на изображение с обложкой. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Заголовок ссылки. • url (str) – Ссылка на подборку. • url_scheme (str) – Ссылка со схемой на подборку. • text_color (str) – Цвет текста (HEX). • background_color (str) – Цвет заднего фона. • background_image_uri (str) – Ссылка на изображение заднего фона. • cover_white (str) – Ссылка на изображение с обложкой TODO. • cover_uri (str, optional) – Ссылка на изображение с обложкой. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[MixLink] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Блок-ссылка на подборку. Тип результата yandex_music.MixLink classmethod de_list(data: dict, client: Client) → List[MixLink] Десериализация списка объектов. Параметры

2.9. Пакет yandex_music.landing 117 Yandex Music API

• data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Блоки-ссылки на подборки. Тип результата list из yandex_music.MixLink downloadBackgroundImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_background_image download_background_image(filename: str, size: str = ’200x200’) → None Загрузка заднего фона. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер заднего фона.

2.9.9 yandex_music.TrackId class yandex_music.TrackId(id_: Optional[int] = None, track_id: Optional[int] = None, album_id: Optional[int] = None, from_: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий уникальный идентификатор трека.

Примечание: Поле track_id используется только у объектах полученных через очередь треков. В остальные случаях id. Поле from_ есть только у объект, которые используются в очереди треков.

id_ Уникальный идентификатор трека. Type int track_id Уникальный идентификатор трека. Type int album_id Уникальный идентификатор альбома. Type int from_ Откуда был получен этот объект. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры

118 Глава 2. Пакет yandex_music Yandex Music API

• id (int) – Уникальный идентификатор трека. • track_id (int) – Уникальный идентификатор трека. • album_id (int, optional) – Уникальный идентификатор альбома. • from (str, optional) – Откуда был получен этот объект. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TrackId] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Уникальный идентификатор трека. Тип результата yandex_music.TrackId classmethod de_list(data: dict, client: Client) → List[TrackId] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Уникальные идентификаторы треков. Тип результата list из yandex_music.TrackId

2.9.10 yandex_music.PersonalPlaylistsData class yandex_music.PersonalPlaylistsData(is_wizard_passed: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий дополнительную информацию о персональном плейлисте. is_wizard_passed TODO. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • is_wizard_passed (bool) – TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.9. Пакет yandex_music.landing 119 Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[PersonalPlaylistsData] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Дополнительная информация о персональном плейлисте. Тип результата yandex_music.PersonalPlaylistsData

2.9.11 yandex_music.Promotion class yandex_music.Promotion(promo_id: str, title: str, subtitle: str, heading: str, url: str, url_scheme: str, text_color: str, gradient: str, image: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий продвижение (рекламу).

Примечание: В цвете может как оказаться HEX (#6c65a9 ), так и какой-нибудь transparent. Ссылка со схемой отличается от просто ссылки наличием yandexmusic:// в начале.

promo_id Уникальный идентификатор рекламы. Type str title Заголовок. Type str subtitle Подзаголовок. Type str heading Верхний заголовок. Type str url Ссылка. Type str url_scheme Ссылка с схемой. Type str text_color Цвет текста. Type str

120 Глава 2. Пакет yandex_music Yandex Music API

gradient Градиент TODO. Type str image Ссылка на рекламное изображение. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • promo_id (str) – Уникальный идентификатор рекламы. • title (str) – Заголовок. • subtitle (str) – Подзаголовок. • heading (str) – Верхний заголовок. • url (str) – Ссылка. • url_scheme (str) – Ссылка с схемой. • text_color (str) – Цвет текста. • gradient (str) – Градиент TODO. • image (str) – Ссылка на рекламное изображение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Promotion] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Продвижение (реклама). Тип результата yandex_music.Promotion classmethod de_list(data: dict, client: Client) → List[Promotion] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Продвижения (реклама). Тип результата list из yandex_music.Promotion

2.9. Пакет yandex_music.landing 121 Yandex Music API

2.9.12 yandex_music.Block class yandex_music.Block(id_: str, type_: str, type_for_from: str, title: str, entities: List[BlockEntity], description: Optional[str] = None, data: Union[PersonalPlaylistsData, PlayContextsData, None] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий блок лендинга.

Примечание: Известные значения поля type_: personal-playlists, play-contexts.

id_ Уникальный идентификатор блока. Type str type_ Тип блока. Type str type_for_from Откуда получен блок (как к нему пришли). Type str title Заголовок. Type str entities Содержимое блока (сущности, объекты). Type list из yandex_music.BlockEntity description Описание. Type str | None data Дополнительные данные. Type yandex_music.PersonalPlaylistsData | yandex_music.PlayContextsData | None client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор блока. • type (str) – Тип блока. • type_for_from (str) – Откуда получен блок (как к нему пришли). • title (str) – Заголовок.

122 Глава 2. Пакет yandex_music Yandex Music API

• entities (list из yandex_music.BlockEntity ) – Содержимое блока (сущности, объекты). • description (str, optional) – Описание. • data (yandex_music.PersonalPlaylistsData | yandex_music. PlayContextsData , optional) – Дополнительные данные. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Block] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Блок лендинга. Тип результата yandex_music.Block classmethod de_list(data: dict, client: Client) → List[Block] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Блоки лендинга. Тип результата list из yandex_music.Block

2.9.13 yandex_music.ChartInfo class yandex_music.ChartInfo(id_: str, type_: str, type_for_from: str, title: str, menu: Optional[ChartInfoMenu], chart: Optional[Playlist], chart_description: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий чарт. id Уникальный идентификатор блока. Type str type Тип блока. Type str type_for_from Откуда получен блок (как к нему пришли). Type str

2.9. Пакет yandex_music.landing 123 Yandex Music API

title Заголовок. Type str menu Меню TODO. Type yandex_music.ChartInfoMenu | None chart Плейлист. Type yandex_music.Playlist | None chart_description Описание. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор блока. • type (str) – Тип блока. • type_for_from (str) – Откуда получен блок (как к нему пришли). • title (str) – Заголовок. • menu (yandex_music.ChartInfoMenu , optional) – Меню TODO. • chart (yandex_music.Playlist , optional) – Плейлист. • chart_description (str, optional) – Описание. • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[ChartInfo] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Чарт. Тип результата yandex_music.ChartInfo

2.9.14 yandex_music.ChartInfoMenu class yandex_music.ChartInfoMenu(items: List[ChartInfoMenuItem], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий меню чарта.

124 Глава 2. Пакет yandex_music Yandex Music API

items Список элементов меню. Type list из yandex_music.ChartInfoMenuItem client Клиент Yandex Music. Type yandex_music.Client

Параметры • items (list из yandex_music.ChartInfoMenuItem ) – Список элементов меню. • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[ChartInfoMenu] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Меню чарта. Тип результата yandex_music.ChartInfoMenu

2.9.15 yandex_music.ChartInfoMenuItem class yandex_music.ChartInfoMenuItem(title: str, url: str, selected: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий элемент меню чарта. title Заголовок. Type str url Постфикс для запроса чарта. Type str selected Текущий ли элемент. Type bool | None client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Заголовок. • url (str) – Постфикс для запроса чарта. • selected (bool, optional) – Текущий ли элемент.

2.9. Пакет yandex_music.landing 125 Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[ChartInfoMenuItem] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Элемент меню. Тип результата yandex_music.ChartInfoMenuItem classmethod de_list(data: list, client: Client) → List[ChartInfoMenuItem] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Список элементов меню чарта. Тип результата list из yandex_music.ChartInfoMenuItem

2.9.16 yandex_music.LandingList class yandex_music.LandingList(type_: str, type_for_from: str, title: str, id_: Optional[str] = None, new_releases: List[int] = None, new_playlists: List[int] = None, podcasts: List[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий список объектов лендинга.

Примечание: Известные значения поля type: new-playlists, new-releases, podcasts. В зависимости от типа будет заполнено то, или иное поле.

type Тип результата. Type str type_for_from Откуда пришло событие. Type str title Заголовок страницы. Type str id Уникальный идентификатор списка. Type str

126 Глава 2. Пакет yandex_music Yandex Music API

new_releases Новые альбомы. Type list из int new_playlists Новые плейлисты. Type list из int podcasts Подкасты. Type list из int client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип результата. • type_for_from (str) – Откуда пришло событие. • title (str) – Заголовок страницы. • id (str, optional) – Уникальный идентификатор списка. • new_releases (list из int, optional) – Новые альбомы. • new_playlists (list из int, optional) – Новые плейлисты. • podcasts (list из int, optional) – Подкасты. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.10 Пакет yandex_music.playlist

2.10.1 yandex_music.User class yandex_music.User(uid: int, login: str, name: Optional[str] = None, display_name: Optional[str] = None, full_name: Optional[str] = None, sex: Optional[str] = None, verified: Optional[bool] = None, regions: List[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject

2.10. Пакет yandex_music.playlist 127 Yandex Music API

Класс, представляющий пользователя.

Примечание: Когда данный класс используется в MadeFor и Playlist, то доступны все поля кроме ‘display_name и full_name. При наличии экземпляра класса в user_info у Track (у самозагруженных треков) доступны толь- ко uid,„login, „display_name‘ и full_name. Поле regions есть только при возвращении пользователей в результатах поисках.

uid Идентификатор пользователя. Type int login Логин пользователя. Type str name Имя пользователя. Type str display_name Отображаемое пользователя. Type str, optional full_name Полное имя пользователя. Type str, optional sex Пол пользователя. Type str verified Участвует ли пользователь в генерации плейлистов дня и т.д., и т.п. Type bool regions Список регионов TODO. Type list из int client Клиент Yandex Music. Type yandex_music.Client

Параметры • uid (int) – Идентификатор пользователя. • login (str) – Логин пользователя. • name (str, optional) – Имя пользователя. • display_name (str, optional) – Отображаемое пользователя.

128 Глава 2. Пакет yandex_music Yandex Music API

• full_name (str, optional) – Полное имя пользователя. • sex (str, optional) – Пол пользователя. • verified (bool, optional) – Участвует ли пользователь в генерации плейлистов дня и т.д., и т.п. • regions (list из int, optional) – Список регионов TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[User] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Пользователь. Тип результата yandex_music.User classmethod de_list(data: dict, client: Client) → List[User] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Пользователи. Тип результата list из yandex_music.User downloadAvatar(filename: str, format_: str = ’normal’) → None Псевдоним для download_avatar download_avatar(filename: str, format_: str = ’normal’) → None Загрузка изображения пользователя. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • format (str, optional) – Формат желаемого изображения (normal, orig, small, big).

2.10.2 yandex_music.MadeFor class yandex_music.MadeFor(user_info: Optional[User], case_forms: Optional[CaseForms], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий пользователя, для которого был сделан плейлист. user_info Пользователь, для которого был сделан плейлист. Type yandex_music.User

2.10. Пакет yandex_music.playlist 129 Yandex Music API

case_forms Склонение имени пользователя, для которого был сделан плейлист. Type yandex_music.CaseForms client Клиент Yandex Music. Type yandex_music.Client

Параметры • user_info (yandex_music.User ) – Пользователь, для которого был сделан плей- лист. • case_forms (yandex_music.CaseForms ) – Склонение имени пользователя, для которого был сделан плейлист. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[MadeFor] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Пользователь, для которого был сделан плейлист. Тип результата yandex_music.MadeFor

2.10.3 yandex_music.PlayCounter class yandex_music.PlayCounter(value: int, description: str, updated: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий счётчик дней.

Примечание: Присутствует только у плейлиста дня. Счётчик считает количество дней подряд, на протяжении которых был прослушан плейлист.

value Значение (количество дней). Type int description Описание счётчика. Type str updated Обновлён ли сегодня (в этих сутках). Type bool

130 Глава 2. Пакет yandex_music Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • value (int) – Значение (количество дней). • description (str) – Описание счётчика. • updated (bool) – Обновлён ли сегодня (в этих сутках). • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PlayCounter] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Счетчик дней. Тип результата yandex_music.PlayCounter

2.10.4 yandex_music.PlaylistAbsence class yandex_music.PlaylistAbsence(kind: int, reason: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий причину отсутствия плейлиста. kind Уникальный идентификатор плейлиста. Type int reason Причина отсутствия. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • kind (int) – Уникальный идентификатор плейлиста. • reason (str) – Причина отсутствия. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.10. Пакет yandex_music.playlist 131 Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[PlaylistAbsence] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Причина отсутствия плейлиста. Тип результата yandex_music.PlaylistAbsence

2.10.5 yandex_music.Playlist class yandex_music.Playlist(owner: Optional[User], cover: Optional[Cover], made_for: Optional[MadeFor], play_counter: Optional[PlayCounter], playlist_absence: Optional[PlaylistAbsence], uid: Optional[int] = None, kind: Optional[int] = None, title: Optional[str] = None, track_count: Optional[int] = None, tags: Optional[list] = None, revision: Optional[int] = None, snapshot: Optional[int] = None, visibility: Optional[str] = None, collective: Optional[bool] = None, url_part: Optional[str] = None, created: Optional[str] = None, modified: Optional[str] = None, available: Optional[bool] = None, is_banner: Optional[bool] = None, is_premiere: Optional[bool] = None, duration_ms: Optional[int] = None, og_image: Optional[str] = None, og_title: Optional[str] = None, og_description: Optional[str] = None, image: Optional[str] = None, cover_without_text: Optional[Cover] = None, contest: Optional[Contest] = None, background_color: Optional[str] = None, text_color: Optional[str] = None, id_for_from: Optional[str] = None, dummy_description: Optional[str] = None, dummy_page_description: Optional[str] = None, dummy_cover: Optional[Cover] = None, dummy_rollover_cover: Optional[Cover] = None, og_data: Optional[OpenGraphData] = None, branding: Optional[Brand] = None, metrika_id: Optional[int] = None, coauthors: List[int] = None, top_artist: List[Artist] = None, recent_tracks: List[TrackId] = None, tracks: List[TrackShort] = None, prerolls: Optional[list] = None, likes_count: Optional[int] = None, similar_playlists: List[Playlist] = None, last_owner_playlists: List[Playlist] = None, generated_playlist_type: Optional[str] = None, animated_cover_uri: Optional[str] = None, ever_played: Optional[bool] = None, description: Optional[str] = None, description_formatted: Optional[str] = None, playlist_uuid: Optional[str] = None, is_for_from=None, regions=None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий плейлист.

Примечание: Под полями с заглушками понимаются поля, которые доступны у умных плей- листов тогда, когда у сервиса мало данных для генерации плейлиста. Известные значения visibility: public - публичный плейлист, private - приватный плейлист.

132 Глава 2. Пакет yandex_music Yandex Music API

Известные значения generated_playlist_type: playlistOfTheDay - Плейлист дня, recentTracks - Пре- мьера, neverHeard - Дежавю, podcasts - Подкасты недели, missedLikes - Тайник, origin - Плейлист с Алисой.

owner Владелец плейлиста. Type yandex_music.User cover Обложка альбома. Type yandex_music.Cover made_for Пользователь для которого был создан плейлист. Присутствует только у персональных плей- листов. Type yandex_music.MadeFor play_counter Счётчик дней. Присутствует только у плейлиста дня. Type yandex_music.PlayCounter playlist_absence Причина отсутствия плейлиста. Type yandex_music.PlaylistAbsence uid Идентификатор владельца плейлиста. Type int kind Идентификатор плейлиста. Type int title Название плейлиста. Type str track_count Количество треков. Type int tags Список тегов плейлиста. Type list revision Актуальность данных TODO. Type int snapshot Версия плейлиста. Увеличивается на 1 при каждом изменении. Type int

2.10. Пакет yandex_music.playlist 133 Yandex Music API

visibility Видимость плейлиста. Type str collective Есть ли у плейлиста соавторы. Type bool url_part Часть ссылки на плейлист („daily‘). Type str created Дата создания в формате ISO 8601. Type str modified Дата последнего изменения в формате ISO 8601. Type str available Доступен TODO. Type bool is_banner Является ли банером TODO. Type bool is_premiere Является ли премьерой TODO. Type bool duration_ms Длительность в миллисекундах. Type int og_image Ссылка на превью Open Graph. Type str og_title Заголовок Open Graph. Type str og_description Описание Open Graph. Type str, optional image Изображение TODO. Type str cover_without_text Обложка без текста.

134 Глава 2. Пакет yandex_music Yandex Music API

Type yandex_music.Cover contest Контест TODO. Type yandex_music.Contest background_color Цвет заднего фона TODO. Type str text_color Цвет текста TODO. Type str id_for_from Откуда пришло событие (уникальный идентификатор объекта) TODO. Type str dummy_description Описание-заглушка плейлиста. Type str dummy_page_description Описание-заглушка страницы. Type str dummy_cover Обложка-заглушка. Type str dummy_rollover_cover Обложка-заглушка TODO. Type str og_data Данные для OpenGraph. Type yandex_music.OpenGraphData branding Бренд. Type yandex_music.Brand metrika_id Уникальный идентификатор счётчика на Яндекс.Метрика. Type int coauthors Перечень ID аккаунтов соавторов плейлиста. Type list из int top_artist Топ артистов TODO. Type list из yandex_music.Artist

2.10. Пакет yandex_music.playlist 135 Yandex Music API

recent_tracks Список ID недавних треков. Type list из yandex_music.TrackId tracks Список треков. Type list из yandex_music.TrackShort prerolls Прерол, проигрываемый перед плейлистом. Присутствует только у персональных плейли- стов. Type list likes_count Количество лайков. Type int similar_playlists Похожие плейлисты. Type list из yandex_music.Playlist last_owner_playlists Последние плейлисты владельца. Type list из yandex_music.Playlist generated_playlist_type Тип генерируемого плейлиста. Type str animated_cover_uri Ссылка на анимированную обложку. Type str ever_played Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO Type str description Описание плейлиста с разметкой Markdown. Type str description_formatted Описание плейлиста. Только текст, без разметки. Type str playlist_uuid TODO. Type str is_for_from TODO. regions Регион TODO.

136 Глава 2. Пакет yandex_music Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • owner (yandex_music.User , optional) – Владелец плейлиста. • cover (yandex_music.Cover , optional) – Обложка альбома. • made_for (yandex_music.MadeFor , optional) – Пользователь для которого был создан плейлист. Присутствует только у персональных плейлистов. • play_counter (yandex_music.PlayCounter , optional) – Счётчик дней. Присут- ствует только у плейлиста дня. • playlist_absence (yandex_music.PlaylistAbsence , optional) – Причина отсут- ствия плейлиста. • uid (int, optional) – Идентификатор владельца плейлиста. • kind (int, optional) – Идентификатор плейлиста. • title (str, optional) – Название плейлиста. • track_count (int, optional) – Количество треков. • tags (list, optional) – Список тегов плейлиста. • revision (int, optional) – Актуальность данных TODO. • snapshot (int, optional) – Версия плейлиста. Увеличивается на 1 при каждом изменении. • visibility (str, optional) – Видимость плейлиста. • collective (bool, optional) – Есть ли у плейлиста соавторы. • url_part (str, optional) – Часть ссылки на плейлист („daily‘). • created (str, optional) – Дата создания в формате ISO 8601. • modified (str, optional) – Дата последнего изменения в формате ISO 8601. • available (bool, optional) – Доступен TODO. • is_banner (bool, optional) – Является ли банером TODO. • is_premiere (bool, optional) – Является ли премьерой TODO. • duration_ms (int, optional) – Длительность в миллисекундах. • og_image (str, optional) – Ссылка на превью Open Graph. • og_title (str, optional) – Заголовок Open Graph. • og_description (str, optional) – Описание Open Graph. • image (str, optional) – Изображение TODO. • cover_without_text (yandex_music.Cover , optional) – Обложка без текста. • contest (yandex_music.Contest , optional) – Контест TODO. • background_color (str, optional) – Цвет заднего фона TODO. • text_color (str, optional) – Цвет текста TODO.

2.10. Пакет yandex_music.playlist 137 Yandex Music API

• id_for_from (str, optional) – Откуда пришло событие (уникальный идентифи- катор объекта) TODO. • dummy_description (str, optional) – Описание-заглушка плейлиста. • dummy_page_description (str, optional) – Описание-заглушка страницы. • dummy_cover (str, optional) – Обложка-заглушка. • dummy_rollover_cover (str, optional) – Обложка-заглушка TODO. • og_data (yandex_music.OpenGraphData , optional) – Данные для OpenGraph. • branding (yandex_music.Brand ) – Бренд. • metrika_id (int, optional) – Уникальный идентификатор счётчика на Ян- декс.Метрика. • coauthors (list из int, optional) – Перечень ID аккаунтов соавторов плейлиста. • top_artist (list из yandex_music.Artist , optional) – Топ артистов TODO. • recent_tracks (list из yandex_music.TrackId , optional) – Список ID недавних треков. • tracks (list из yandex_music.TrackShort , optional) – Список треков. • prerolls (list, optional) – Прерол, проигрываемый перед плейлистом. Присут- ствует только у персональных плейлистов. • likes_count (int, optional) – Количество лайков. • similar_playlists (list из yandex_music.Playlist , optional) – Похожие плей- листы. • last_owner_playlists (list из yandex_music.Playlist , optional) – Последние плейлисты владельца. • generated_playlist_type (str, optional) – Тип генерируемого плейлиста. • animated_cover_uri (str, optional) – Ссылка на анимированную обложку. • ever_played (str, optional) – Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO • description (str, optional) – Описание плейлиста с разметкой Markdown. • description_formatted (str, optional) – Описание плейлиста. Только текст, без разметки. • playlist_uuid (str, optional) – TODO. • is_for_from – TODO. • regions – Регион TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Playlist] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

138 Глава 2. Пакет yandex_music Yandex Music API

Результат Плейлист. Тип результата yandex_music.Playlist classmethod de_list(data: dict, client: Client) → List[Playlist] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Плейлисты. Тип результата list из yandex_music.Playlist dislike(*args, **kwargs) → bool Сокращение для: client.users_likes_playlists_remove(playlist.uid, user.id *args, **kwargs) downloadAnimatedCover(filename: str, size: str = ’200x200’) → None Псевдоним для download_animated_cover downloadOgImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_og_image download_animated_cover(filename: str, size: str = ’200x200’) → None Загрузка анимированной обложки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением (GIF). • size (str, optional) – Размер анимированной обложки. download_og_image(filename: str, size: str = ’200x200’) → None Загрузка обложки. Используйте это только когда нет self.cover! Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. fetchTracks(*args, **kwargs) → List[TrackShort] Псевдоним для fetch_tracks fetch_tracks(*args, **kwargs) → List[TrackShort] Сокращение для: client.users_playlists(playlist.kind, playlist.owner.id, *args, **kwargs).tracks getRecommendations(*args, **kwargs) → Optional[PlaylistRecommendations] Псевдоним для get_recommendations get_recommendations(*args, **kwargs) → Optional[PlaylistRecommendations] Сокращение для: client.users_playlists_recommendations(playlist.kind, playlist.owner.uid, *args, **kwargs)

2.10. Пакет yandex_music.playlist 139 Yandex Music API

isMine Псевдоним для is_mine is_mine like(*args, **kwargs) → bool Сокращение для: client.users_likes_playlists_add(playlist.uid, user.id *args, **kwargs) playlistId Псевдоним для playlist_id playlist_id rename(name: str) → None

2.10.6 yandex_music.CaseForms class yandex_music.CaseForms(nominative: str, genitive: str, dative: str, accusative: str, instrumental: str, prepositional: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий склонение имени. nominative Именительный. Type str genitive Родительный. Type str dative Дательный. Type str accusative Винительный. Type str instrumental Творительный. Type str prepositional Предложный. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • nominative (str) – Именительный.

140 Глава 2. Пакет yandex_music Yandex Music API

• genitive (str) – Родительный. • dative (str) – Дательный. • accusative (str) – Винительный. • instrumental (str) – Творительный. • prepositional (str) – Предложный. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[CaseForms] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат TODO. Тип результата yandex_music.CaseForms

2.10.7 yandex_music.PlaylistId class yandex_music.PlaylistId(uid: int, kind: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий уникальный идентификатор плейлиста. uid Уникальный идентификатор пользователя владеющим плейлистом. Type int kind Уникальный идентификатор плейлиста. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • uid (int) – Уникальный идентификатор пользователя владеющим плейлистом. • kind (int) – Уникальный идентификатор плейлиста. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PlaylistId] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта.

2.10. Пакет yandex_music.playlist 141 Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Уникальный идентификатор плейлиста. Тип результата yandex_music.PlaylistId classmethod de_list(data: dict, client: Client) → List[PlaylistId] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Уникальные идентификаторы плейлистов. Тип результата list из yandex_music.PlaylistId

2.10.8 yandex_music.PlaylistRecommendations class yandex_music.PlaylistRecommendations(tracks: List[Track], batch_id: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий рекомендации для плейлиста. tracks Список рекомендованных треков. Type list из yandex_music.Track batch_id Уникальный идентификатор партии треков. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • tracks (list из yandex_music.Track ) – Список рекомендованных треков. • batch_id (str, optional) – Уникальный идентификатор партии треков. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PlaylistRecommendations] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Рекомендации для плейлиста. Тип результата yandex_music.PlaylistRecommendations

142 Глава 2. Пакет yandex_music Yandex Music API

2.10.9 yandex_music.TagResult

class yandex_music.TagResult(tag: str, ids: List[PlaylistId], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий тег и его плейлисты. tag Тег. Type yandex_music.Tag ids Уникальные идентификаторы плейлистов тега. Type list из yandex_music.PlaylistId client Клиент Yandex Music. Type yandex_music.Client

Параметры • tag (yandex_music.Tag ) – Тег. • ids (list из yandex_music.PlaylistId ) – Уникальные идентификаторы плей- листов тега. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TagResult] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Тег и его плейлисты. Тип результата yandex_music.TagResult

2.10.10 yandex_music.Tag class yandex_music.Tag(id_: str, value: str, name: str, og_description: str, og_image: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий тег (подборку). id Уникальный идентификатор тега. Type str value Значение тега (название в lower case).

2.10. Пакет yandex_music.playlist 143 Yandex Music API

Type str name Название тега (отображаемое). Type str og_description Описание тега для OpenGraph. Type str og_image Ссылка на изображение для OpenGraph. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор тега. • value (str) – Значение тега (название в lower case). • name (str) – Название тега (отображаемое). • og_description (str) – Описание тега для OpenGraph. • og_image (str, optional) – Ссылка на изображение для OpenGraph. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Tag] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Тег. Тип результата yandex_music.Tag

2.10.11 yandex_music.Contest class yandex_music.Contest(contest_id: str, status: str, can_edit: bool, sent: Optional[str] = None, withdrawn: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий контест TODO.

Примечание: Известные значения поля status: editing, withdrew-moderator.

144 Глава 2. Пакет yandex_music Yandex Music API

contest_id Уникальный идентификатор. Type str status Статус. Type str can_edit Разрешено ли редактирование. Type bool sent Дата отправки. Type str withdrawn Дата вывода (окончания). Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • contest_id (str) – Уникальный идентификатор. • status (str) – Статус. • can_edit (bool) – Разрешено ли редактирование. • sent (str, optional) – Дата отправки. • withdrawn (str, optional) – Дата вывода (окончания). • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Contest] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Контест. Тип результата yandex_music.Contest

2.10.12 yandex_music.OpenGraphData class yandex_music.OpenGraphData(title: str, description: str, image: Cover, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject

2.10. Пакет yandex_music.playlist 145 Yandex Music API

Класс, представляющий данные для Open Graph. title Заголовок. Type str description Описание. Type str image Изображение. Type yandex_music.Cover client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Заголовок. • description (str) – Описание. • image (yandex_music.Cover ) – Изображение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[OpenGraphData] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Данные для Open Graph. Тип результата yandex_music.OpenGraphData

2.10.13 yandex_music.Brand class yandex_music.Brand(image: str, background: str, reference: str, pixels: List[str], theme: str, playlist_theme: str, button: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий бренд плейлиста.

Примечание: Отслеживание просмотров на сторонник сервисах бренда, рекомендация следу- ющего контента.

image Ссылка на изображение.

146 Глава 2. Пакет yandex_music Yandex Music API

Type str background Цвет заднего фона. Type str reference URI ссылка на содержимое. Type str pixels Ссылки на gif изображения для отслеживания просмотров (web beacon). Type list из str theme Тема оформления. Type str playlist_theme Тема плейлиста TODO. Type str button Текст кнопки. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • image (str) – Ссылка на изображение. • background (str) – Цвет заднего фона. • reference (str) – URI ссылка на содержимое. • pixels (list из str) – Ссылки на gif изображения для отслеживания просмот- ров (web beacon). • theme (str) – Тема оформления. • playlist_theme (str) – Тема плейлиста TODO. • button (str) – Текст кнопки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Brand] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

2.10. Пакет yandex_music.playlist 147 Yandex Music API

Результат Бренд плейлиста. Тип результата yandex_music.Brand

2.11 Пакет yandex_music.queue

2.11.1 yandex_music.Queue class yandex_music.Queue(context: Optional[Context], tracks: List[TrackId], current_index: int, modified: str, id_: Optional[str] = None, from_: Optional[str] =None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий очередь треков. context Объект по которому построена очередь. Type yandex_music.Context | None tracks Список треков. Type list из yandex_music.TrackId current_index Текущий проигрываемый трек. Type int modified Дата последнего изменения. Type str id Уникальный идентификатор очереди. Type str from_ Откуда был получен этот объект. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • context (yandex_music.Context | None) – Объект по которому построена оче- редь. • tracks (list из yandex_music.TrackId ) – Список треков. • current_index (int) – Текущий проигрываемый трек. • modified (str) – Дата последнего изменения. • id (str, optional) – Уникальный идентификатор очереди.

148 Глава 2. Пакет yandex_music Yandex Music API

• from (str, optional) – Откуда был получен этот объект. • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[Queue] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Очередь. Тип результата yandex_music.Queue

2.11.2 yandex_music.QueueItem class yandex_music.QueueItem(id_: str, context: Optional[Context], modified: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий очередь треков в списке очередей устройств. id Уникальный идентификатор очереди. Type str context Объект по которому построена очередь. Type yandex_music.Context | None modified Дата последнего изменения. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор очереди. • context (yandex_music.Context | None) – Объект по которому построена оче- редь. • modified (str) – Дата последнего изменения. • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[QueueItem] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

2.11. Пакет yandex_music.queue 149 Yandex Music API

Результат Очередь в списке. Тип результата yandex_music.QueueItem classmethod de_list(data: dict, client: Client) → List[QueueItem] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Список очередей всех устройств. Тип результата list из yandex_music.QueueItem

2.11.3 yandex_music.Context class yandex_music.Context(type_: str, id_: Optional[str] = None, description: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий содержимое очереди.

Примечание: Известные значения поля type: various, my_music, radio, playlist, artist. Тип various используется при прослушивании из раздела «Моя музыка» с сайта, а my_music с мобильных клиентов. Поле description зачастую есть только когда type имеет значение my_music или various. При type равным my_music или various поле id отсутствует.

type Тип содержимого (по чём построена очередь). Type str id Уникальный идентификатор типа содержимого (плейлиста, альбома и т.д.). Type str description Описание содержимого (например, название плейлиста, радиостанции). Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип содержимого (по чём построена очередь). • id (str, optional) – Уникальный идентификатор типа содержимого (плейлиста, альбома и т.д.).

150 Глава 2. Пакет yandex_music Yandex Music API

• description (str, optional) – Описание содержимого (например, название плей- листа, радиостанции). • client (yandex_music.Client , optional) – Клиент Yandex Music.

classmethod de_json(data: dict, client: Client) → Optional[Context] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Содержимое очереди. Тип результата yandex_music.Context

2.12 Пакет yandex_music.rotor

2.12.1 yandex_music.RotorSettings class yandex_music.RotorSettings(language: str, diversity: str, mood: Optional[int] = None, energy: Optional[int] = None, mood_energy: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий настройки станции.

Примечание: Поля energy, mood используются в старых настройках (settings1 ). Значения mood_energy: fun, active, calm, sad, all. Значения diversity: favorite, popular, discover, default. Значения language: not-russian, russian, any.

language Язык. Type str diversity Разнообразие (треки). Type str mood Настроение (старое). Type int energy Энергичное. Type int mood_energy Настроение.

2.12. Пакет yandex_music.rotor 151 Yandex Music API

Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • language (str) – Язык. • diversity (str) – Разнообразие (треки). • mood (int, optional) – Настроение (старое). • energy (int, optional) – Энергичное. • mood_energy (str, optional) – Настроение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[RotorSettings] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Настройки станции. Тип результата yandex_music.RotorSettings

2.12.2 yandex_music.DiscreteScale class yandex_music.DiscreteScale(type_: str, name: str, min_: Optional[Value], max_: Optional[Value], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий дискретное значение.

Примечание: Известные значения поля type: discrete-scale.

type Тип. Type str name Название. Type str min Минимальное значение. Type yandex_music.Value

152 Глава 2. Пакет yandex_music Yandex Music API

max Максимальное значение. Type yandex_music.Value client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип. • name (str) – Название. • min (yandex_music.Value ) – Минимальное значение. • max (yandex_music.Value ) – Максимальное значение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[DiscreteScale] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Дискретное значение. Тип результата yandex_music.DiscreteScale

2.12.3 yandex_music.Enum class yandex_music.Enum(type_: str, name: str, possible_values: List[Value], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий перечисления. type Тип перечисления. Type str name Название перечисления. Type str possible_values Доступные значения. Type list из yandex_Music.Value client Клиент Yandex Music. Type yandex_music.Client

2.12. Пакет yandex_music.rotor 153 Yandex Music API

Параметры • type (str) – Тип перечисления. • name (str) – Название перечисления. • possible_values (list из yandex_Music.Value) – Доступные значения. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Enum] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Перечисление. Тип результата yandex_music.Enum

2.12.4 yandex_music.Id class yandex_music.Id(type_: str, tag: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий уникальный идентификатор станции.

Примечание: Известные типы станций: user, genre.

type Тип станции. Type str tag Тег станции. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип станции. • tag (str) – Тег станции. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Id] Десериализация объекта.

154 Глава 2. Пакет yandex_music Yandex Music API

Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Уникальный идентификатор станции. Тип результата yandex_music.Id

2.12.5 yandex_music.Sequence class yandex_music.Sequence(type_: str, track: Optional[Track], liked: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий звено последовательности.

Примечание: Известные значения поля type_: track. Возможно есть ad.

type_ Тип звена. Type str track Трек. Type yandex_music.Track | None liked Связанное ли. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип звена. • track (yandex_music.Track | None) – Трек. • liked (bool) – Связанное ли. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Sequence] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Звено последовательности.

2.12. Пакет yandex_music.rotor 155 Yandex Music API

Тип результата yandex_music.Sequence classmethod de_list(data: dict, client: Client) → List[Sequence] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Последовательность треков. Тип результата list из yandex_music.Sequence

2.12.6 yandex_music.Station class yandex_music.Station(id_: Optional[Id], name: str, icon: Icon, mts_icon: Icon, geocell_icon: Icon, id_for_from: str, restrictions: Restrictions, restrictions2: Restrictions, full_image_url: Optional[str] = None, mts_full_image_url: Optional[str] = None, parent_id: Optional[Id] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий станцию.

Примечание: id_for_from обозначает предка станции, например, жанр, настроение или заня- тие. Неизвестно когда используется id_for_from, а когда parent_id.

id Уникальный идентификатор станции. Type yandex_music.Id name Название станции. Type str icon Иконка станции. Type yandex_music.Icon mts_icon Иконка TODO. Type yandex_music.Icon geocell_icon Иконка TODO. Type yandex_music.Icon id_for_from Категория (тип) станции. Type str

156 Глава 2. Пакет yandex_music Yandex Music API

restrictions Ограничения для настроек станции старого формата. Type yandex_music.Restrictions restrictions2 Ограничения для настроек станции. Type yandex_music.Restrictions full_image_url Ссылка на полное изображение. Type str mts_full_image_url Ссылка на полную иконку. Type str parent_id Уникальный идентификатор станции, являющейся предком текущей. Type yandex_music.Id client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (yandex_music.Id ) – Уникальный идентификатор станции. • name (str) – Название станции. • icon (yandex_music.Icon ) – Иконка станции. • mts_icon (yandex_music.Icon ) – Иконка TODO. • geocell_icon (yandex_music.Icon ) – Иконка TODO. • id_for_from (str) – Категория (тип) станции. • restrictions (yandex_music.Restrictions ) – Ограничения для настроек стан- ции старого формата. • restrictions2 (yandex_music.Restrictions ) – Ограничения для настроек станции. • full_image_url (str, optional) – Ссылка на полное изображение. • mts_full_image_url (str, optional) – Ссылка на полную иконку. • parent_id (yandex_music.Id , optional) – Уникальный идентификатор станции, являющейся предком текущей. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Station] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта.

2.12. Пакет yandex_music.rotor 157 Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Станция. Тип результата yandex_music.Station

2.12.7 yandex_music.AdParams class yandex_music.AdParams(partner_id: Union[str, int], category_id: Union[str, int], page_ref: str, target_ref: str, other_params: str, ad_volume: int, genre_id: Optional[str] = None, genre_name: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий параметры рекламного объявления.

Примечание: Известные дополнительные параметры(other_params): user:{ID}.

partner_id Уникальный идентификатор заказчика рекламы. Type str | int category_id Уникальный идентификатор категории рекламы. Type str | int page_ref Ссылка на ссылающуюся страницу. Type str target_ref Ссылка на целевую страницу. Type str other_params Другие параметры. Type str ad_volume Громкость воспроизводимой рекламы. Type int genre_id Уникальный идентификатор жанра. Type str genre_name Название жанра. Type str client Клиент Yandex Music. Type yandex_music.Client

158 Глава 2. Пакет yandex_music Yandex Music API

Параметры • partner_id (str | int) – Уникальный идентификатор заказчика рекламы. • category_id (str | int) – Уникальный идентификатор категории рекламы. • page_ref (str) – Ссылка на ссылающуюся страницу. • target_ref (str) – Ссылка на целевую страницу. • other_params (str) – Другие параметры. • ad_volume (int) – Громкость воспроизводимой рекламы. • genre_id (str, optional) – Уникальный идентификатор жанра. • genre_name (str, optional) – Название жанра. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[AdParams] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Параметры рекламного объявления. Тип результата yandex_music.AdParams

2.12.8 yandex_music.Dashboard class yandex_music.Dashboard(dashboard_id: str, stations: List[StationResult], pumpkin: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий рекомендованные станций пользователя. dashboard_id Уникальный идентификатор панели. Type str stations Станции со всеми возможными настройками и параметрами. Type list из yandex_music.StationResult pumpkin Хэллоуин. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры

2.12. Пакет yandex_music.rotor 159 Yandex Music API

• dashboard_id (str) – Уникальный идентификатор панели. • stations (list из yandex_music.StationResult ) – Станции со всеми возмож- ными настройками и параметрами. • pumpkin (bool) – Хэллоуин. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Dashboard] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Рекомендованные станций пользователя. Тип результата yandex_music.Dashboard

2.12.9 yandex_music.Value class yandex_music.Value(value: str, name: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий значение(переменную). value Значение. Type str name Название. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • value (str) – Значение. • name (str) – Название. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Value] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

160 Глава 2. Пакет yandex_music Yandex Music API

Результат Значение. Тип результата yandex_music.Value classmethod de_list(data: dict, client: Client) → List[Value] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Значения. Тип результата list из yandex_music.Value

2.12.10 yandex_music.Restrictions class yandex_music.Restrictions(language: Optional[Enum], diversity: Optional[Enum], mood: Optional[DiscreteScale] = None, energy: Optional[DiscreteScale] = None, mood_energy: Optional[Enum] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий ограничения для настроек станции. language Перечисление значений для языков. Type yandex_music.Enum diversity Перечисление значений для разнообразия (треков). Type yandex_music.Enum mood Ограничение для значений настроения. Type yandex_music.DiscreteScale energy Ограничение для значений энергичности. Type yandex_music.DiscreteScale mood_energy Значения для настроения. Type yandex_music.Enum client Клиент Yandex Music. Type yandex_music.Client

Параметры • language (yandex_music.Enum ) – Перечисление значений для языков. • diversity (yandex_music.Enum ) – Перечисление значений для разнообразия (треков).

2.12. Пакет yandex_music.rotor 161 Yandex Music API

• mood (yandex_music.DiscreteScale , optional) – Ограничение для значений на- строения. • energy (yandex_music.DiscreteScale , optional) – Ограничение для значений энергичности. • mood_energy (yandex_music.Enum , optional) – Значения для настроения. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Restrictions] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ограничения для настроек станции. Тип результата yandex_music.Restrictions

2.12.11 yandex_music.StationResult class yandex_music.StationResult(station: Optional[Station], settings: Optional[RotorSettings], settings2: Optional[RotorSettings], ad_params: Optional[AdParams], explanation: Optional[str] = None, prerolls: Optional[list] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий радиостанцию с настройками. station Станция. Type yandex_music.Station | None settings Первый набор настроек. Type yandex_music.RotorSettings | None settings2 Второй набор настроек. Type yandex_music.RotorSettings | None ad_params Настройки рекламы. Type yandex_music.AdParams | None explanation TODO. Type str prerolls Прероллы TODO.

162 Глава 2. Пакет yandex_music Yandex Music API

Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • station (yandex_music.Station | None) – Станция. • settings (yandex_music.RotorSettings | None) – Первый набор настроек. • settings2 (yandex_music.RotorSettings | None) – Второй набор настроек. • ad_params (yandex_music.AdParams | None) – Настройки рекламы. • explanation (str, optional) – TODO. • prerolls (list из str, optional) – Прероллы TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[StationResult] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Радиостанция с настройками. Тип результата yandex_music.StationResult classmethod de_list(data: dict, client: Client) → List[StationResult] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Радиостанции с настройками. Тип результата list из yandex_music.StationResult

2.12.12 yandex_music.StationTracksResult class yandex_music.StationTracksResult(id_: Optional[Id], sequence: List[Sequence], batch_id: str, pumpkin: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий последовательность треков станции. id_ Уникальный идентификатор станции. Type yandex_music.Id | None

2.12. Пакет yandex_music.rotor 163 Yandex Music API

sequence Последовательность треков. Type list из yandex_music.Sequence batch_id Уникальный идентификатор партии (последовательности). Type str pumpkin Хэллоуин. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (yandex_music.Id ) – Уникальный идентификатор станции. • sequence (list из yandex_music.Sequence ) – Последовательность треков. • batch_id (str) – Уникальный идентификатор партии (последовательности). • pumpkin (bool) – Хэллоуин. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data, client) → Optional[yandex_music.rotor.station_tracks_result.StationTracksResult] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Последовательность треков станции. Тип результата yandex_music.StationTracksResult

2.12.13 yandex_music.StationData class yandex_music.StationData(name: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию о личной станции. name Название станции. Type str client Клиент Yandex Music. Type yandex_music.Client

164 Глава 2. Пакет yandex_music Yandex Music API

Параметры • name (str) – Название станции. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[StationData] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация о личной станции. Тип результата yandex_music.StationData

2.13 Пакет yandex_music.search

2.13.1 yandex_music.Suggestions class yandex_music.Suggestions(best: Optional[Best], suggestions: List[str], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий подсказки при поиске. best Лучший результат. Type yandex_music.Best suggestions Список подсказок-дополнений для поискового запроса. Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • best (yandex_music.Best ) – Лучший результат. • suggestions (list из str) – Список подсказок-дополнений для поискового за- проса. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Suggestions] Десериализация объекта. Параметры

2.13. Пакет yandex_music.search 165 Yandex Music API

• data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Подсказки при поиске. Тип результата yandex_music.Suggestions

2.13.2 yandex_music.Search class yandex_music.Search(search_request_id: str, text: str, best: Optional[Best], albums: Optional[SearchResult], artists: Optional[SearchResult], playlists: Optional[SearchResult], tracks: Optional[SearchResult], videos: Optional[SearchResult], users: Optional[SearchResult], podcasts: Optional[SearchResult], podcast_episodes: Optional[SearchResult], type_: Optional[str] = None, page: Optional[int] = None, per_page: Optional[int] = None, misspell_result: Optional[str] = None, misspell_original: Optional[str] = None, misspell_corrected: Optional[bool] = None, nocorrect: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий результаты поиска. search_request_id ID запроса. Type str text Текст запроса. Type str best Лучший результат. Type yandex_music.Best albums Найденные альбомы. Type yandex_music.SearchResult artists Найденные исполнители. Type yandex_music.SearchResult playlists Найденные плейлисты. Type yandex_music.SearchResult tracks Найденные треки. Type yandex_music.SearchResult videos Найденные видео. Type yandex_music.SearchResult

166 Глава 2. Пакет yandex_music Yandex Music API

users Найденные пользователи. Type yandex_music.SearchResult podcasts Найденные подскасты. Type yandex_music.SearchResult podcast_episodes Найденные выпуски подкастов. Type yandex_music.SearchResult type_ Тип результата по которому искали (аргумент в Client.search). Type str page Текущая страница. Type int per_page Результатов на странице. Type int misspell_result Запрос с автоматическим исправлением. Type str misspell_original Оригинальный запрос. Type str misspell_corrected Был ли исправлен запрос. Type bool nocorrect Было ли отключено исправление результата. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • search_request_id (str) – ID запроса. • text (str) – Текст запроса. • best (yandex_music.Best ) – Лучший результат. • albums (yandex_music.SearchResult ) – Найденные альбомы. • artists (yandex_music.SearchResult ) – Найденные исполнители.

2.13. Пакет yandex_music.search 167 Yandex Music API

• playlists (yandex_music.SearchResult ) – Найденные плейлисты. • tracks (yandex_music.SearchResult ) – Найденные треки. • videos (yandex_music.SearchResult ) – Найденные видео. • users (yandex_music.SearchResult ) – Найденные пользователи. • podcasts (yandex_music.SearchResult ) – Найденные подскасты. • podcast_episodes (yandex_music.SearchResult ) – Найденные выпуски подка- стов. • type (str) – Тип результата по которому искали (аргумент в Client.search). • page (int, optional) – Текущая страница. • per_page (int, optional) – Результатов на странице. • misspell_result (str, optional) – Запрос с автоматическим исправлением. • misspell_original (str, optional) – Оригинальный запрос. • misspell_corrected (bool, optional) – Был ли исправлен запрос. • nocorrect (bool, optional) – Было ли отключено исправление результата. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Search] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Результаты поиска. Тип результата yandex_music.Search

2.13.3 yandex_music.SearchResult class yandex_music.SearchResult(type_: str, total: int, per_page: int, order: int, results: List[Union[yandex_music.track.track.Track, yandex_music.artist.artist.Artist, yandex_music.album.album.Album, yandex_music.playlist.playlist.Playlist, yandex_music.video.Video]], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий результаты поиска.

Примечание: Значения поля type: track, artist, playlist, album, video.

type Тип результата.

168 Глава 2. Пакет yandex_music Yandex Music API

Type str total Количество результатов. Type int per_page Максимальное количество результатов на странице. Type int order Позиция блока. Type int results Результаты поиска. Type list из yandex_music.Track | yandex_music.Artist | yandex_music.Album | yandex_music.Playlist | yandex_music.Video client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип результата. • total (int) – Количество результатов. • per_page (int) – Максимальное количество результатов на странице. • order (int) – Позиция блока. • results (list из yandex_music.Track | yandex_music.Artist | yandex_music. Album | yandex_music.Playlist | yandex_music.Video ) – Результаты поиска. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client, type_: str = None) → Optional[SearchResult] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • type (str, optional) – Тип результата. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Результаты поиска. Тип результата yandex_music.SearchResult

2.13. Пакет yandex_music.search 169 Yandex Music API

2.13.4 yandex_music.Best class yandex_music.Best(type_: str, result: Union[yandex_music.track.track.Track, yandex_music.artist.artist.Artist, yandex_music.album.album.Album, yandex_music.playlist.playlist.Playlist, yandex_music.video.Video, None], text: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий лучший результат поиска. type_ Тип лучшего результата. Type str result Лучший результат. Type yandex_music.Track | yandex_music.Artist | yandex_music.Album | yandex_music.Playlist | yandex_music.Video text TODO. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип лучшего результата. • result (yandex_music.Track | yandex_music.Artist | yandex_music.Album | yandex_music.Playlist | yandex_music.Video ) – Лучший результат. • text (str, optional) – TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Best] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Лучший результат. Тип результата yandex_music.Best

170 Глава 2. Пакет yandex_music Yandex Music API

2.14 Пакет yandex_music.shot

2.14.1 yandex_music.Shot class yandex_music.Shot(order: int, played: bool, shot_data: ShotData, shot_id: str, status: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий шот от Алисы.

Примечание: Известные значения поля status: ready.

order Порядковый номер при воспроизведении. Type int played Был ли проигран шот. Type bool shot_data Основная информация о шоте. Type yandex_music.ShotData shot_id Уникальный идентификатор шота. Type str status Статус шота. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • order (int) – Порядковый номер при воспроизведении. • played (bool) – Был ли проигран шот. • shot_data (yandex_music.ShotData ) – Основная информация о шоте. • shot_id (str) – Уникальный идентификатор шота. • status (str) – Статус шота. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Shot] Десериализация объекта. Параметры

2.14. Пакет yandex_music.shot 171 Yandex Music API

• data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Шот от Алисы. Тип результата yandex_music.Shot classmethod de_list(data: dict, client: Client) → List[Shot] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Шоты от Алисы. Тип результата list из yandex_music.Shot

2.14.2 yandex_music.ShotData class yandex_music.ShotData(cover_uri: str, mds_url: str, shot_text: str, shot_type: ShotType, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий основную информацию о шоте. cover_uri Ссылка на обложку шота (иконка Алисы). Type str mds_url Ссылка на аудиоверсию шота в озвучке от Алисы. Type str shot_text Текстовая версия шота. Type str shot_type Тип шота. Type yandex_music.ShotType client Клиент Yandex Music. Type yandex_music.Client

Параметры • cover_uri (str) – Ссылка на обложку шота (иконка Алисы). • mds_url (str) – Ссылка на аудиоверсию шота в озвучке от Алисы. • shot_text (str) – Текстовая версия шота. • shot_type (yandex_music.ShotType ) – Тип шота.

172 Глава 2. Пакет yandex_music Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ShotData] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Основная информация о шоте. Тип результата yandex_music.ShotData downloadCover(filename: str, size: str = ’200x200’) → None Псевдоним для download_cover downloadMds(filename: str) → None Псевдоним для download_mds download_cover(filename: str, size: str = ’200x200’) → None Загрузка обложки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. download_mds(filename: str) → None Загрузка аудиоверсии шота. Параметры filename (str) – Путь для сохранения файла с названием и расшире- нием.

2.14.3 yandex_music.ShotEvent class yandex_music.ShotEvent(event_id: str, shots: List[Shot], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий событие-шот перед началом следующего трека. event_id Уникальный идентификатор события. Type str shots Шоты от Алисы. Type list из yandex_music.Shot client Клиент Yandex Music. Type yandex_music.Client

Параметры • event_id (str) – Уникальный идентификатор события.

2.14. Пакет yandex_music.shot 173 Yandex Music API

• shots (list из yandex_music.Shot ) – Шоты от Алисы. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ShotEvent] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Событие-шот перед началом следующего трека. Тип результата yandex_music.ShotEvent

2.14.4 yandex_music.ShotType class yandex_music.ShotType(id_: str, title: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий тип шота от Алисы. id Уникальный идентификатор типа. Type str title Заголовок шота. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (str) – Уникальный идентификатор типа. • title (str) – Заголовок шота. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[ShotType] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Тип шота от Алисы. Тип результата yandex_music.ShotType

174 Глава 2. Пакет yandex_music Yandex Music API

2.15 Пакет yandex_music.supplement

2.15.1 yandex_music.Supplement class yandex_music.Supplement(id_: int, lyrics: Optional[Lyrics], videos: List[VideoSupplement], radio_is_available: bool = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий дополнительную информацию о треке. id Уникальный идентификатор дополнительной информации. Type int lyrics Текст песни. Type yandex_music.Lyrics videos Видео. Type yandex_music.VideoSupplement radio_is_available Доступно ли радио. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int) – Уникальный идентификатор дополнительной информации. • lyrics (yandex_music.Lyrics ) – Текст песни. • videos (yandex_music.VideoSupplement ) – Видео. • radio_is_available (bool, optional) – Доступно ли радио. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Supplement] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Дополнительная информация о треке. Тип результата yandex_music.Supplement

2.15. Пакет yandex_music.supplement 175 Yandex Music API

2.15.2 yandex_music.Lyrics class yandex_music.Lyrics(id_: int, lyrics: str, full_lyrics: str, has_rights: bool, show_translation: bool, text_language: Optional[str] = None, url: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий текст трека. id Уникальный идентификатор текста трека. Type int lyrics Первые строки текст песни. Type str has_rights Есть ли права. Type bool full_lyrics Текст песни. Type str text_language Язык текста. Type str show_translation Доступен ли перевод. Type bool url Ссылка на источник перевода. Обычно genius.com. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int) – Уникальный идентификатор текста трека. • lyrics (str) – Первые строки текст песни. • has_rights (bool) – Есть ли права. • full_lyrics (str) – Текст песни. • show_translation (bool) – Доступен ли перевод. • text_language (str, optional) – Язык песни. • url (str, optional) – Ссылка на источник перевода. Обычно genius.com. • client (yandex_music.Client , optional) – Клиент Yandex Music.

176 Глава 2. Пакет yandex_music Yandex Music API

• **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Lyrics] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Текст трека. Тип результата yandex_music.Lyrics

2.15.3 yandex_music.VideoSupplement class yandex_music.VideoSupplement(cover: str, title: str, provider: str, provider_video_id: Optional[str] = None, url: Optional[str] = None, embed_url: Optional[str] = None, embed: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий видеоклипы. cover URL на обложку видео. Type str title Название видео. Type str provider Сервис поставляющий видео. Type str provider_video_id Уникальный идентификатор видео на сервисе. Type str url URL на видео. Type str embed_url URL на видео, находящегося на серверах Яндекса. Type str embed HTML тег для встраивания видео. Type str client Клиент Yandex Music. Type yandex_music.Client

2.15. Пакет yandex_music.supplement 177 Yandex Music API

Параметры • cover (str) – URL на обложку видео. • title (str) – Название видео. • provider (str) – Сервис поставляющий видео. • provider_video_id (str, optional) – Уникальный идентификатор видео на сер- висе. • url (str, optional) – URL на видео. • embed_url (str, optional) – URL на видео, находящегося на серверах Яндекса. • embed (str, optional) – HTML тег для встраивания видео. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[VideoSupplement] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Видеоклип. Тип результата yandex_music.VideoSupplement classmethod de_list(data: dict, client: Client) → List[VideoSupplement] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Видеоклипы. Тип результата list из yandex_music.VideoSupplement

2.16 Пакет yandex_music.track

2.16.1 yandex_music.Normalization class yandex_music.Normalization(gain: float, peak: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий значения для нормализации трека. gain Значение гейна, которое нужно применить к аудиосигналу. Type str

178 Глава 2. Пакет yandex_music Yandex Music API

peak Пиковая точка волны аудиосигнала. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • gain (str) – Значение гейна, которое нужно применить к аудиосигналу. • peak (int) – Пиковая точка волны аудиосигнала. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Normalization] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Значения для нормализации трека. Тип результата yandex_music.Normalization

2.16.2 yandex_music.Major class yandex_music.Major(id_: int, name: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий мейджор-лейбл звукозаписи. id_ Уникальный идентификатор. Type int name Название. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int) – Уникальный идентификатор. • name (str) – Название. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.16. Пакет yandex_music.track 179 Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[Major] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Мейджор-лейбл звукозаписи. Тип результата yandex_music.Major

2.16.3 yandex_music.Track class yandex_music.Track(id_: Union[str, int], title: Optional[str] = None, available: Optional[bool] = None, artists: List[Artist] = None, albums: List[Album] = None, available_for_premium_users: Optional[bool] = None, lyrics_available: Optional[bool] = None, poetry_lover_matches: List[PoetryLoverMatch] = None, best: Optional[bool] = None, real_id: Union[str, int, None] = None, og_image: Optional[str] = None, type_: Optional[str] = None, cover_uri: Optional[str] = None, major: Optional[Major] = None, duration_ms: Optional[int] = None, storage_dir: Optional[str] = None, file_size: Optional[int] = None, substituted: Optional[Track] = None, matched_track: Optional[Track] = None, normalization: Optional[Normalization] = None, error: Optional[str] = None, can_publish: Optional[bool] = None, state: Optional[str] = None, desired_visibility: Optional[str] = None, filename: Optional[str] = None, user_info: Optional[User] = None, meta_data: Optional[MetaData] = None, regions: Optional[List[str]] = None, available_as_rbt: Optional[bool] = None, content_warning: Optional[str] = None, explicit: Optional[bool] = None, preview_duration_ms: Optional[int] = None, available_full_without_permission: Optional[bool] = None, version: Optional[str] = None, remember_position: Optional[bool] = None, background_video_uri: Optional[str] = None, short_description: Optional[str] = None, is_suitable_for_children: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий трек.

Примечание: Известные значения поля content_warning: explicit. Известные значения поля type: music. Поля can_publish, state, desired_visibility, filename, user_info доступны только у треков что были загружены пользователем. Обычно у подкастов поле remember_position == True, а у треков remember_position == False.

id Уникальный идентификатор. Type int | str title Название.

180 Глава 2. Пакет yandex_music Yandex Music API

Type str available Доступен ли для прослушивания. Type bool artists Исполнители. Type list из yandex_music.Artist albums Альбомы. Type list из yandex_music.Album available_for_premium_users Доступен ли для пользователей с подпиской. Type bool lyrics_available Доступен ли текст песни. Type bool poetry_lover_matches Список слов TODO. Type list из yandex_music.PoetryLoverMatch best Лучшей ли трек TODO. Type bool real_id TODO. Type int | str og_image Ссылка на превью Open Graph. Type str type Тип. Type str cover_uri Ссылка на изображение с обложкой. Type str major Мейджор-лейбл. Type yandex_music.Major | None duration_ms Длительность трека в миллисекундах. Type int

2.16. Пакет yandex_music.track 181 Yandex Music API

storage_dir В какой папке на сервере хранится файл TODO. Type str file_size Размер файла. TODO добавить единицу измерения. Type int substituted Замещённый трек. Type yandex_music.Track matched_track Соответствующий трек TODO. Type yandex_music.Track normalization Значения для нормализации трека. Type list из yandex_music.Normalization error Сообщение об ошибке. Type str can_publish Может ли быть опубликован. Type bool state Состояние, например, playable. Type str desired_visibility Видимость трека. Type str filename Название файла. Type str user_info Информация о пользователе, который загрузил трек. Type yandex_music.User meta_data Информация о метаданных трека. Type yandex_music.MetaData regions Регион TODO. Type list из str available_as_rbt TODO.

182 Глава 2. Пакет yandex_music Yandex Music API

Type bool content_warning Тип откровенного контента. Type str explicit Содержит ли откровенный контент. Type bool preview_duration_ms TODO. Type int available_full_without_permission Доступен ли без подписки. Type bool version Версия. Type str remember_position Если True, то запоминатся последняя позиция прослушивания, иначе позиция не запомина- ется. Type bool download_info Информация о вариантах загрузки трека. Type list из yandex_music.DownloadInfo background_video_uri Ссылка на видеошот. Type str short_description Краткое опсание эпизода подкаста. Type str is_suitable_for_children Подходит ли для детей TODO. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • id (int | str) – Уникальный идентификатор. • title (str, optional) – Название. • available (bool, optional) – Доступен ли для прослушивания. • artists (list из yandex_music.Artist , optional) – Исполнители.

2.16. Пакет yandex_music.track 183 Yandex Music API

• albums (list из yandex_music.Album , optional) – Альбомы. • available_for_premium_users (bool, optional) – Доступен ли для пользовате- лей с подпиской. • lyrics_available (bool, optional) – Доступен ли текст песни. • poetry_lover_matches (list из yandex_music.PoetryLoverMatch , optional) – Список слов TODO. • best (bool, optional) – Лучшей ли трек TODO. • real_id (int | str, optional) – TODO. • og_image (str, optional) – Ссылка на превью Open Graph. • type (str, optional) – Тип. • cover_uri (str, optional) – Ссылка на изображение с обложкой. • major (yandex_music.Major , optional) – Мейджор-лейбл. • duration_ms (int, optional) – Длительность трека в миллисекундах. • storage_dir (str, optional) – В какой папке на сервере хранится файл TODO. • file_size (int, optional) – Размер файла. TODO добавить единицу измерения. • substituted (yandex_music.Track , optional) – Замещённый трек. • matched_track (yandex_music.Track , optional) – Соответствующий трек TODO. • normalization (list из yandex_music.Normalization , optional) – Значения для нормализации трека. • error (str, optional) – Сообщение об ошибке. • can_publish (bool, optional) – Может ли быть опубликован. • state (str, optional) – Состояние, например, playable. • desired_visibility (str, optional) – Видимость трека. • filename (str, optional) – Название файла. • user_info (yandex_music.User , optional) – Информация о пользователе, кото- рый загрузил трек. • meta_data (yandex_music.MetaData , optional) – Информация о метаданных тре- ка. • regions (list из str, optional) – Регион TODO. • available_as_rbt (bool, optional) – TODO. • content_warning (str, optional) – Тип откровенного контента. • explicit (bool, optional) – Содержит ли откровенный контент. • preview_duration_ms (int, optional) – TODO. • available_full_without_permission (bool, optional) – Доступен ли без под- писки. • version (str, optional) – Версия. • remember_position (bool, optional) – Если True, то запоминатся последняя по- зиция прослушивания, иначе позиция не запоминается.

184 Глава 2. Пакет yandex_music Yandex Music API

• background_video_uri (str, optional) – Ссылка на видеошот. • short_description (str, optional) – Краткое опсание эпизода подкаста. • is_suitable_for_children (bool, optional) – Подходит ли для детей TODO. • client (yandex_music.Client ) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Track] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Трек. Тип результата yandex_music.Track classmethod de_list(data: dict, client: Client) → List[Track] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Треки. Тип результата list из yandex_music.Track dislike(*args, **kwargs) → bool Сокращение для: client.users_likes_tracks_remove(track.id, user.id *args, **kwargs) download(filename: str, codec: str = ’mp3’, bitrate_in_kbps: int = 192 ) → None Загрузка трека.

Примечание: Известные значения codec: mp3, aac. Известные значения bitrate_in_kbps: 64, 128, 192, 320.

Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • codec (str, optional) – Кодек из доступных в self.download_info. • bitrate_in_kbps (int, optional) – Битрейт из доступных в self.download_info для данного кодека. Raises yandex_music.exceptions.InvalidBitrate – Если в self.download_info не найден подходящий трек.

downloadCover(filename: str, size: str = ’200x200’) → None Псевдоним для download_cover

2.16. Пакет yandex_music.track 185 Yandex Music API

downloadOgImage(filename: str, size: str = ’200x200’) → None Псевдоним для download_og_image download_cover(filename: str, size: str = ’200x200’) → None Загрузка обложки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. download_og_image(filename: str, size: str = ’200x200’) → None Загрузка обложки. Предпочтительнее использовать self.download_cover(). Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер обложки. getDownloadInfo(get_direct_links=False) → List[DownloadInfo] Псевдоним для get_download_info getSupplement(*args, **kwargs) → Optional[Supplement] Псевдоним для get_supplement get_download_info(get_direct_links=False) → List[DownloadInfo] Сокращение для: client.tracks_download_info(self.track_id, get_direct_links) get_supplement(*args, **kwargs) → Optional[Supplement] Сокращение для: client.track_supplement(track.id, *args, **kwargs) like(*args, **kwargs) → bool Сокращение для: client.users_likes_tracks_add(track.id, user.id, *args, **kwargs) trackId Псевдоним для track_id track_id Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера. Type str

2.16.4 yandex_music.MetaData class yandex_music.MetaData(album: Optional[str] = None, volume: Optional[int] = None, year: Optional[int] = None, number: Optional[int] = None, genre: Optional[str] = None, lyricist: Optional[str] = None, version: Optional[str] = None, composer: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий метаданные трека.

186 Глава 2. Пакет yandex_music Yandex Music API

album Название альбома. Type str volume Диск (раздел). Type int year Год выхода. Type int number Позиция в альбоме. Type int genre Жанр. Type str lyricist Текст песни. Есть только у пользовательских треков. Type str version Версия TODO. Type str, optional composer Композитор TODO. Type str, optional client Клиент Yandex Music. Type yandex_music.Client

Параметры • album (str, optional) – Название альбома. • volume (int, optional) – Диск (раздел). • year (int, optional) – Год выхода. • number (int, optional) – Позиция в альбоме. • genre (str, optional) – Жанр. • lyricist (str, optional) – Текст песни. Есть только у пользовательских треков. • version (str, optional) – Версия TODO. • composer (str, optional) – Композитор TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

2.16. Пакет yandex_music.track 187 Yandex Music API

classmethod de_json(data: dict, client: Client) → Optional[MetaData] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Метаданные трека Тип результата yandex_music.MetaData

2.16.5 yandex_music.LicenceTextPart class yandex_music.LicenceTextPart(text: str, url: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий часть текста с ссылкой на лицензионное соглашение. text Часть текста (строка). Type str url Ссылка на лицензионное соглашение. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • text (str) – Часть текста (строка). • url (str, optional) – Ссылка на лицензионное соглашение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

188 Глава 2. Пакет yandex_music Yandex Music API

• data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Строки текста с ссылкой на лицензионное соглашение. Тип результата list из yandex_music.LicenceTextPart

2.16.6 yandex_music.PoetryLoverMatch class yandex_music.PoetryLoverMatch(begin: int, end: int, line: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий слова в тексте TODO.

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

begin Индекс начала. Type int end Индекс конца. Type int line Индекс строки. Type int client Клиент Yandex Music. Type yandex_music.Client

Параметры • begin (int) – Индекс начала. • end (int) – Индекс конца. • line (int) – Индекс строки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PoetryLoverMatch] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Позиция слова.

2.16. Пакет yandex_music.track 189 Yandex Music API

Тип результата yandex_music.PoetryLoverMatch classmethod de_list(data: dict, client: Client) → List[PoetryLoverMatch] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Список с позициями слов. Тип результата list из yandex_music.PoetryLoverMatch

2.17 Пакет yandex_music.utils

2.17.1 yandex_music.utils.request.Request class yandex_music.utils.request.Request(client=None, headers=None, proxy_url=None) Базовые классы: object Вспомогательный класс для yandex_music, представляющий методы для выполнения POST и GET запросов, скачивания файлов. Параметры • client (yandex_music.Client , optional) – Клиент Yandex Music. • headers (dict, optional) – Заголовки передаваемые с каждым запросом. • proxy_url (str, optional) – Прокси. static _convert_camel_to_snake(text: str) → str Конвертация CamelCase в SnakeCase. Параметры text (str) – Название переменной в CamelCase. Результат Название переменной в SnakeCase. Тип результата str static _object_hook(obj: dict) → dict Нормализация имён переменных пришедших с API.

Примечание: В названии переменной заменяет «-» на «_», конвертирует в SnakeCase, если название является зарезервированным именем или «client» - добавляет «_» в конец. Если название переменной начинается с цифры - добавляет в начало «_».

Параметры obj (dict) – Словарь, где ключ название переменной, а значение - содержимое. Результат Тот же словарь, что и на входе, но с нормализованными ключами. Тип результата dict

190 Глава 2. Пакет yandex_music Yandex Music API

_parse(json_data: bytes) → Optional[yandex_music.utils.response.Response] Разбор ответа от API.

Примечание: Если данные отсутствуют в result, то переформировывает ответ используя данные из корня.

Параметры json_data (bytes) – Ответ от API. Результат Ответ API. Тип результата yandex_music.utils.response.Response Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки.

_request_wrapper(*args, **kwargs) Обёртка над запросом библиотеки requests.

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

Параметры • *args – Произвольные аргументы для requests.request. • **kwargs – Произвольные ключевые аргументы для requests.request. Результат Ответ API. Тип результата yandex_music.utils.response.Response Raises • yandex_music.exceptions.TimedOut – При превышении времени ожидания. • yandex_music.exceptions.Unauthorized – При невалидном токене, долгом ожидании прямой ссылки на файл. • yandex_music.exceptions.BadRequest – При неправильном запросе. • yandex_music.exceptions.NetworkError – При проблемах с сетью. • yandex_music.exceptions.CaptchaWrong – При неправильной капче. • yandex_music.exceptions.CaptchaRequired – При необходимости пройти капчу.

download(url, filename, timeout=5, *args, **kwargs) Отправка запроса на получение содержимого и его запись в файл. Параметры • url (str) – Адрес для запроса. • filename (str) – Путь и(или) название файла вместе с расширением. • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула.

2.17. Пакет yandex_music.utils 191 Yandex Music API

• *args – Произвольные аргументы для requests.request. • **kwargs – Произвольные ключевые аргументы для requests.request. Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. get(url: str, params: dict = None, timeout: Union[int, float] = 5, *args, **kwargs) Отправка GET запроса. Параметры • url (str) – Адрес для запроса. • params (str) – GET параметры для запроса. • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула. • *args – Произвольные аргументы для requests.request. • **kwargs – Произвольные ключевые аргументы для requests.request. Результат Ответ API. Тип результата yandex_music.utils.response.Response Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. post(url, data=None, timeout=5, *args, **kwargs) Отправка POST запроса. Параметры • url (str) – Адрес для запроса. • data (str) – POST тело запроса. • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула. • *args – Произвольные аргументы для requests.request. • **kwargs – Произвольные ключевые аргументы для requests.request. Результат Ответ API. Тип результата yandex_music.utils.response.Response Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. retrieve(url, timeout=5, *args, **kwargs) Отправка GET запроса и получение содержимого без обработки (парсинга). Параметры • url (str) – Адрес для запроса. • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула. • *args – Произвольные аргументы для requests.request. • **kwargs – Произвольные ключевые аргументы для requests.request. Результат Экземляр объекта ответа библиотеки requests.

192 Глава 2. Пакет yandex_music Yandex Music API

Тип результата Response Raises yandex_music.exceptions.YandexMusicError – Базовое исключение биб- лиотеки. set_and_return_client(client) → Client Принимает клиент и присваивает его текущему объекту. При наличии авторизации добав- ляет заголовок. Параметры client (yandex_music.Client ) – Клиент Yandex Music. Результат Клиент Yandex Music. Тип результата yandex_music.Client set_authorization(token: str) → None Добавляет заголовок авторизации для каждого запроса.

Примечание: Используется при передаче своего экземпляра Request’a клиенту.

Параметры token (str) – OAuth токен.

set_language(lang: str) → None Добавляет заголовок языка для каждого запроса.

Примечание: Возможные значения lang: en/uz/uk/us/ru/kk/hy.

Параметры lang (str) – Язык.

2.17.2 yandex_music.utils.response.Response class yandex_music.utils.response.Response(data: dict, invocation_info: Optional[InvocationInfo] = None, result: dict = None, error: str = None, error_description: str = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий ответ API.

Примечание: У ответа сервера два варианта возврата данных. Через корень (без вложенности, на уровне invocation_info) используется от силы пару раз. И в поле result. Второй считается основным. В data лежит копия всего ответа.

data Ответ на запрос. Используется тогда, когда отсутствует result. Type dict invocation_info Информация о запросе.

2.17. Пакет yandex_music.utils 193 Yandex Music API

Type yandex_music.InvocationInfo | None result Ответ на запрос (секция с результатом). Type dict error Код ошибки. Type str error_description Описание ошибки. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • data (dict) – Ответ на запрос. Используется тогда, когда отсутствует result. • invocation_info (yandex_music.InvocationInfo , optional) – Информация о за- просе. • result (dict, optional) – Ответ на запрос (секция с результатом). • error (str, optional) – Код ошибки. • error_description (str, optional) – Описание ошибки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Response] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ответ API. Тип результата yandex_music.utils.response.Response error Код ошибки вместе с описанием Type str result Результат выполнения запроса. Данный для распаковки. Type dict

194 Глава 2. Пакет yandex_music Yandex Music API

2.17.3 yandex_music.utils.captcha_response.CaptchaResponse class yandex_music.utils.captcha_response.CaptchaResponse(x_captcha_url, x_captcha_key, error_description, error, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий ответ сервера с запросом на ввод капчи. x_captcha_url Ссылка на изображение с капчей. Type str x_captcha_key Уникальный ключ капчи. Type str error_description Описание ошибки. Type str error Код ошибки. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • x_captcha_url (str) – Ссылка на изображение с капчей. • x_captcha_key (str) – Уникальный ключ капчи. • error_description (str) – Описание ошибки. • error (str) – Код ошибки. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Ответ сервера с запросом на ввод капчи. Тип результата yandex_music.utils.captcha_response.CaptchaResponse download(filename=None) Загрузка изображения с капчей.

2.17. Пакет yandex_music.utils 195 Yandex Music API

Параметры filename (str, optional) – Путь и(или) название файла вместе с рас- ширением. По умолчанию ключ капчи и расширение .gif.

2.17.4 yandex_music.utils.difference.Difference class yandex_music.utils.difference.Operation Базовые классы: enum.Enum Класс перечисления типов операций для изменения плейлиста.

Примечание: Существует две операции: вставка, удаление.

DELETE = 'delete' INSERT = 'insert' class yandex_music.utils.difference.Difference Базовые классы: object Класс, представляющий обёртку над созданием данных для запроса изменения плейлиста.

Примечание: Результатом является перечень (массив) операций, которые будут применены к плейлисту. Конечной разницей (набором операций) является JSON, который будет отправлен в теле запроса.

operations Перечень операция для изменения плейлиста. Type list из dict add_delete(from_: int, to: int) → yandex_music.utils.difference.Difference Добавление операции удаления.

Примечание: Передаётся диапазон для удаления треков.

Параметры • from (int) – С какого индекса. • to (int) – По какой индекс. Результат Набор операций над плейлистом. Тип результата yandex_music.utils.difference.Difference

add_insert(at: int, tracks: Union[dict, List[dict]]) → yandex_music.utils.difference.Difference Добавление операции вставки.

Примечание: В tracks передаётся словарь с двумя ключами: id, album_id. Это нужно для формирования операции.

Параметры

196 Глава 2. Пакет yandex_music Yandex Music API

• at (int) – Индекс для вставки. • tracks (dict | list: из :obj:`dict) – Словарь уникальными идентификато- рами треков. Результат Набор операций над плейлистом. Тип результата yandex_music.utils.difference.Difference

to_json() → str Сериализация всех операций над плейлистом. Результат Сформированное тело для запроса. Тип результата str

2.18 yandex_music.Cover class yandex_music.Cover(type_: Optional[str] = None, uri: Optional[str] = None, items_uri: Optional[str] = None, dir_: Optional[str] = None, version: Optional[str] = None, custom: Optional[bool] = None, is_custom: Optional[bool] = None, copyright_name: Optional[str] = None, copyright_cline: Optional[str] = None, prefix: Optional[str] = ,None error: Optional[str] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий обложку. type Тип обложки. Type str uri Ссылка на изображение. Type str items_uri Список ссылок на изображения. Type str dir Директория хранения изображения на сервере. Type str version Версия. Type str is_custom Является ли обложка пользовательской. Type bool custom Является ли обложка пользовательской. Type bool

2.18. yandex_music.Cover 197 Yandex Music API

prefix Уникальный идентификатор. Type str copyright_name Название владельца авторским правом. Type str copyright_cline Владелец прав на музыку (автор текста и т.д.), а не её записи. Type str error Сообщение об ошибке. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str, optional) – Тип обложки. • uri (str, optional) – Ссылка на изображение. • items_uri (str, optional) – Список ссылок на изображения. • dir (str, optional) – Директория хранения изображения на сервере. • version (str, optional) – Версия. • is_custom (bool, optional) – Является ли обложка пользовательской. • custom (bool, optional) – Является ли обложка пользовательской. • prefix (str, optional) – Уникальный идентификатор. • copyright_name (str, optional) – Название владельца авторским правом. • copyright_cline (str, optional) – Владелец прав на музыку (автор текста и т.д.), а не её записи. • error (str, optional) – Сообщение об ошибке. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Cover] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Обложка. Тип результата yandex_music.Cover

198 Глава 2. Пакет yandex_music Yandex Music API

classmethod de_list(data: dict, client: Client) → List[Cover] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Обложки. Тип результата list из yandex_music.Cover download(filename: str, index: int = 0, size: str = ’200x200’) → None Загрузка обложки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • index (int, optional) – Индекс элемента в списке ссылок на обложки если нет self.uri. • size (str, optional) – Размер изображения.

2.19 yandex_music.Like class yandex_music.like.Like(type_: str, id_=None, timestamp: Optional[str] = None, album: Optional[Album] = None, artist: Optional[Artist] = None, playlist: Optional[Playlist] = None, short_description: Optional[str] = None, description: Optional[str] = None, is_premiere: Optional[bool] = None, is_banner: Optional[bool] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий объект с отметкой «мне нравится». None: В поле type содержится одно из трёх значений: artist, playlist, album. Обозначает поле, в котором содержится информация. type Тип объекта с отметкой. Type str id Уникальный идентификатор отметки. Type str timestamp Дата и время добавления отметки. Type str album Понравившейся альбом. Type yandex_music.Album

2.19. yandex_music.Like 199 Yandex Music API

artist Понравившейся артист. Type yandex_music.Artist playlist Понравившейся плейлист. Type yandex_music.Playlist short_description Короткое описание. Type str description Описание. Type str is_premiere Премьера ли. Type bool is_banner Является ли баннером. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • type (str) – Тип объекта с отметкой. • id (str, optional) – Уникальный идентификатор отметки. • timestamp (str, optional) – Дата и время добавления отметки. • album (yandex_music.Album , optional) – Понравившейся альбом. • artist (yandex_music.Artist , optional) – Понравившейся артист. • playlist (yandex_music.Playlist , optional) – Понравившейся плейлист. • short_description (str, optional) – Короткое описание. • description (str, optional) – Описание. • is_premiere (bool, optional) – Премьера ли. • is_banner (bool, optional) – Является ли баннером. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client, type_: str = None) → Optional[Like] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта.

200 Глава 2. Пакет yandex_music Yandex Music API

• type (str, optional) – Тип объекта с отметкой «мне нравится». • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Объект с отметкой «мне нравится». Тип результата yandex_music.Like classmethod de_list(data: dict, client: Client, type_: str = None) → List[Like] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • type (str, optional) – Тип объекта с отметкой «мне нравится». • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Объекты с отметкой «мне нравится». Тип результата list из yandex_music.Like

2.20 yandex_music.DownloadInfo class yandex_music.DownloadInfo(codec: str, bitrate_in_kbps: int, gain: bool, preview: bool, download_info_url: str, direct: bool, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию о вариантах загрузки трека. codec Кодек аудиофайла. Type str bitrate_in_kbps Битрейт аудиофайла в кбит/с. Type int gain Усиление TODO. Type bool preview Предварительный просмотр TODO. Type bool download_info_url Ссылка на XML документ содержащий данные для загрузки трека. Type str direct Прямая ли ссылка. Type bool

2.20. yandex_music.DownloadInfo 201 Yandex Music API

direct_link Прямая ссылка на загрузку. Доступна после получения ссылки. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • codec (str) – Кодек аудиофайла. • bitrate_in_kbps (int) – Битрейт аудиофайла в кбит/с. • gain (bool) – Усиление TODO. • preview (bool) – Предварительный просмотр TODO. • download_info_url (str) – Ссылка на XML документ содержащий данные для загрузки трека. • direct (bool) – Прямая ли ссылка. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[DownloadInfo] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Варианты загрузки треков. Тип результата yandex_music.DownloadInfo classmethod de_list(data: dict, client: Client, get_direct_links: bool = False) → List[DownloadInfo] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • get_direct_links (bool) – Получать ли сразу прямые ссылки на загрузку. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Варианты загрузки треков. Тип результата list из yandex_music.DownloadInfo download(filename: str) → None Загрузка трека. Параметры filename (str) – Путь и(или) название файла вместе с расширением. getDirectLink() → str Псевдоним для get_direct_link

202 Глава 2. Пакет yandex_music Yandex Music API

get_direct_link() → str Получение прямой ссылки на загрузку из XML ответа. Метод доступен только одну минуту с момента получения информации о загрузке, иначе 410 ошибка! Результат Прямая ссылка на загрузку трека. Тип результата str

2.21 yandex_music.Experiments

class yandex_music.Experiments(client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий какие-то свистелки-перделки, флажки, режимы экспериментальных функций. client Клиент Yandex Music. Type yandex_music.Client название_эксперимента Содержит режим или состояние, или функцию, или ещё что угодно. Type str

Параметры • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Собственно тут и передаются все эти свистелки.

classmethod de_json(data: dict, client: Client) → Optional[Experiments] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Какие-то свистелки-перделки, флажки, режимы экспериментальных функций. Тип результата yandex_music.Experiments

2.22 yandex_music.Icon class yandex_music.Icon(background_color: str, image_url: str, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий иконку. background_color Цвет заднего фона в HEX.

2.21. yandex_music.Experiments 203 Yandex Music API

Type str image_url Ссылка на изображение. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • background_color (str) – Цвет заднего фона в HEX. • image_url (str) – Ссылка на изображение. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Icon] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Иконка. Тип результата yandex_music.Icon download(filename: str, size: str = ’200x200’) → None Загрузка иконки. Параметры • filename (str) – Путь для сохранения файла с названием и расширением. • size (str, optional) – Размер иконки. get_url(size: str = ’200x200’) Получение URL иконки. Параметры size (str, optional) – Размер иконки.

2.23 yandex_music.InvocationInfo class yandex_music.InvocationInfo(hostname: str, req_id: str, exec_duration_millis: Optional[int] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий информацию о запросе. hostname Имя удалённого сервера. Type str

204 Глава 2. Пакет yandex_music Yandex Music API

req_id Номер запроса. Type str exec_duration_millis Время выполнения в миллисекундах. Type str client Клиент Yandex Music. Type yandex_music.Client

Параметры • hostname (str) – Имя удалённого сервера. • req_id (str) – Номер запроса. • exec_duration_millis (str, optional) – Время выполнения в миллисекундах. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[InvocationInfo] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Информация о запросе. Тип результата yandex_music.InvocationInfo

2.24 yandex_music.Pager class yandex_music.Pager(total: int, page: int, per_page: int, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий пагинатор. total Всего треков. Type int page Номер страницы. Type int per_page Количество треков на странице. Type int

2.24. yandex_music.Pager 205 Yandex Music API

client Клиент Yandex Music. Type yandex_music.Client

Параметры • total (int) – Всего треков. • page (int) – Номер страницы. • per_page (int) – Количество треков на странице. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Pager] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Пагинатор. Тип результата yandex_music.Pager

2.25 yandex_music.PermissionAlerts class yandex_music.PermissionAlerts(alerts: List[str], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий оповещения. alerts Список оповещений. Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • alerts (list из str) – Список оповещений. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PermissionAlerts] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music.

206 Глава 2. Пакет yandex_music Yandex Music API

Результат Оповещение. Тип результата yandex_music.PermissionAlerts

2.26 yandex_music.PromoCodeStatus class yandex_music.PromoCodeStatus(status: str, status_desc: str, account_status: Optional[Status], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий статус активации промо-кода. status Статус операции. Type str status_desc Описание статуса. Type str account_status Информация об аккаунте пользователя. Type yandex_music.Status client Клиент Yandex Music. Type yandex_music.Client

Параметры • status (str) – Статус операции. • status_desc (str) – Описание статуса. • account_status (yandex_music.Status ) – Информация об аккаунте пользова- теля. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[PromoCodeStatus] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Статус активации промо-кода. Тип результата yandex_music.PromoCodeStatus

2.26. yandex_music.PromoCodeStatus 207 Yandex Music API

2.27 yandex_music.Settings class yandex_music.Settings(in_app_products: List[Product], native_products: List[Product], web_payment_url: str, promo_codes_enabled: bool, web_payment_month_product_price: Optional[Price] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий предложения по покупке. in_app_products Продаваемые продукты внутри приложения. Type list из yandex_music.Product native_products Продаваемые продукты всплывающими окнами. Type list из yandex_music.Product web_payment_url Ссылка для осуществления платежа. Type str web_payment_month_product_price Цена продукта за месяц. Type yandex_music.Price promo_codes_enabled Доступно ли использование промо-кодов. Type bool client Клиент Yandex Music. Type yandex_music.Client

Параметры • in_app_products (list из yandex_music.Product ) – Продаваемые продукты внутри приложения. • native_products (list) – Продаваемые продукты всплывающими окнами. • web_payment_url (str) – Ссылка для осуществления платежа. • web_payment_month_product_price (yandex_music.Price , optional) – Цена про- дукта за месяц. • promo_codes_enabled (bool) – Доступно ли использование промо-кодов. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Settings] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта.

208 Глава 2. Пакет yandex_music Yandex Music API

• client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Предложение по покупке. Тип результата yandex_music.Settings

2.28 yandex_music.TrackShort class yandex_music.TrackShort(id_: Union[str, int], timestamp: str, album_id: Optional[str] = None, play_count: Optional[int] = None, recent: Optional[bool] = None, chart: Optional[Chart] = None, track: Optional[Track] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий укороченную версию трека с неполными данными.

Примечание: Поля chart и track только у треков, полученных через метод chart().

id Уникальный идентификатор трека. Type str timestamp Дата TODO. Type str album_id Уникальный идентификатор альбома. Type str play_count Количество проигрываний. Type int recent Недавний. Type bool chart Позиция в чарте. Type yandex_music.Chart track Полная версия трека. Type yandex_music.Track client Клиент Yandex Music. Type yandex_music.Client

Параметры

2.28. yandex_music.TrackShort 209 Yandex Music API

• id (str) – Уникальный идентификатор трека. • timestamp (str) – Дата TODO. • album_id (str, optional) – Уникальный идентификатор альбома. • play_count (int, optional) – Количество проигрываний. • recent (bool, optional) – Недавний. • chart (yandex_music.Chart , optional) – Позиция в чарте. • track (yandex_music.Track , optional) – Полная версия трека. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TrackShort] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Укороченная версия трека с неполными данными. Тип результата yandex_music.TrackShort classmethod de_list(data: dict, client: Client) → List[TrackShort] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Укороченные версии треков с неполными данными. Тип результата list из yandex_music.TrackShort fetchTrack() → Track Псевдоним для fetch_track fetch_track() → Track Получение полной версии трека. Результат Полная версия трека. Тип результата yandex_music.Track trackId Псевдоним для track_id track_id Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера. Type str

210 Глава 2. Пакет yandex_music Yandex Music API

2.29 yandex_music.TracksList class yandex_music.TracksList(uid: int, revision: int, tracks: List[TrackShort], client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий список треков. uid Уникальный идентификатор пользователя. Type int revision Актуальность данных TODO. Type int tracks Список треков в укороченной версии. Type list из yandex_music.TrackShort client Клиент Yandex Music. Type yandex_music.Client

Параметры • uid (int) – Уникальный идентификатор пользователя. • revision (int) – Актуальность данных TODO. • tracks (list из yandex_music.TrackShort ) – Список треков в укороченной вер- сии. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[TracksList] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client , optional) – Клиент Yandex Music. Результат Список треков. Тип результата yandex_music.TracksList tracksIds Псевдоним для tracks_ids tracks_ids Список уникальных идентификаторов треков. Type list из str

2.29. yandex_music.TracksList 211 Yandex Music API

2.30 yandex_music.Video class yandex_music.Video(title: str, cover: Optional[str] = None, embed_url: Optional[str] = None, provider: Optional[str] = None, provider_video_id: Union[str, int, None] = None, youtube_url: Optional[str] = None, thumbnail_url: Optional[str] = None, duration: Optional[int] = None, text: Optional[str] = None, html_auto_play_video_player: Optional[str] = None, regions: Optional[List[str]] = None, client: Optional[Client] = None, **kwargs) Базовые классы: yandex_music.base.YandexMusicObject Класс, представляющий видео. title Название видео. Type str cover Ссылка на изображение. Type str embed_url Ссылка на видео. Type str provider Провайдер видео. Type str provider_video_id Идентификатор видео. Type int | str youtube_url Ссылка на видео Youtube. Type str thumbnail_url Ссылка на изображение. Type str duration Длительность видео в секундах. Type int text Текст. Type str html_auto_play_video_player HTML тег для встраивания в разметку страницы. Type str regions Регион TODO.

212 Глава 2. Пакет yandex_music Yandex Music API

Type list из str client Клиент Yandex Music. Type yandex_music.Client

Параметры • title (str) – Название видео. • cover (str, optional) – Ссылка на изображение. • embed_url (str, optional) – Ссылка на видео. • provider (str, optional) – Провайдер видео. • provider_video_id (int | str, optional) – Идентификатор видео. • youtube_url (str, optional) – Ссылка на видео Youtube. • thumbnail_url (str, optional) – Ссылка на изображение. • duration (int, optional) – Длительность видео в секундах. • text (str, optional) – Текст. • html_auto_play_video_player (str, optional) – HTML тег для встраивания в разметку страницы. • regions (list из str, optional) – Регион TODO. • client (yandex_music.Client , optional) – Клиент Yandex Music. • **kwargs – Произвольные ключевые аргументы полученные от API.

classmethod de_json(data: dict, client: Client) → Optional[Video] Десериализация объекта. Параметры • data (dict) – Поля и значения десериализуемого объекта. • client (yandex_music.Client ) – Клиент Yandex Music. Результат Видео. Тип результата yandex_music.Video classmethod de_list(data: dict, client: Client) → List[Video] Десериализация списка объектов. Параметры • data (list) – Список словарей с полями и значениями десериализуемого объ- екта. • client (yandex_music.Client ) – Клиент Yandex Music. Результат Видео. Тип результата list из yandex_music.Video

2.30. yandex_music.Video 213 Yandex Music API

214 Глава 2. Пакет yandex_music Глава 3

Список изменений

3.1 Версия 0.1.1

25.03.2020 Закончено документирование всех классов и основных методов! Переломные изменения • Классы отметок «мне нравится» для альбомов, плейлистов и исполнителей обобщены. Теперь представлены одним классом.

– Удаленные классы: ∗ ArtistsLikes. ∗ AlbumsLikes. ∗ PlaylistsLikes. – Новый класс: Like (поле type для определения содержимого). • Изменено название пакета с status на account (#195). • Исправлено выбрасываемое исключение при таймауте: – Прошлое исключение: TimeoutError (built-in). – Новое исключение: TimedOut (yandex_music.exceptions). • Удалены следующие файлы: requirements.txt, requirements-dev.txt, requirements-docs.txt. Крупные изменения • Добавлено обнаружение новых полей с просьбой сообщить о них (#216). – Добавлена проверка на неизвестные поля. – Добавлен вывод отладочной информации в виде warning’a. – Добавлен шаблон issue для отправки логов.

215 Yandex Music API

• Добавлено поле type для класса SearchResult для определения типа результата поиска по объ- екту. • Добавлены настройки пользователя (#195): – Добавлен класс UserSettings. – Добавлен метод для получения своих настроек (account_settings). – Добавлен метод для получения настроек другого пользователя (users_settings). – Добавлен метод для изменения настроек (account_settings_set). • Добавлен возможность получить похожие треки (#197): – Добавлен класс TracksSimilar с полями трека и списка похожих треков. – Добавлен метод для получения похожих треков (tracks_similar). • Добавлены шоты от Алисы (#185): – Добавлен метод after_track в класс Client для получения контента для воспоризведе- ния после трека (реклама, шот). – Добавлены методы для загрузки обложки и аудиоверсии шота. – Добавлены новые классы: ∗ Shot ∗ ShotData ∗ ShotEvent ∗ ShotType • Добавлен метод для изменения видимости плейлиста (#179). • Добавлена поддержка Яндекс.Радио (#20): – Исправлена отправка фидбека. – Написана инструкция по использованию (в доке к методу). – Добавлен аругмент для перехода по цепочке треков. – Добавлен метод для изменения настроек станции. Незначительные изменения и/или исправления • Убрано дублирование информации в документации (#247). • Добавленые новые поля в класс Track: version, remember_position (#238). • Добавлено исключение InvalidBitrate при попытке загрузить недопустимый трек по критериям (кодек, битрейт). • Исправлено получение прямой ссылки на файл с кодеком AAC (#237, #25). • Исправлено получение плейлиста с Алисой в лендинге (#185). • Исправлено название поля с ссылкой на источник в классе Description (с url на uri). • Исправлена десериализация несуществующего исполнителя. • Добавлено поле version в класс Album (#178). • Поле picture класса Vinyl теперь опциональное. • Поле week класса Ratings теперь опциональное.

216 Глава 3. Список изменений Yandex Music API

• Поле product_id класса AutoRenewable теперь опциональное (#182). • Правки замечаний по codacy.

3.2 Версия 0.0.16

29.12.2019 Переломные изменения • Поле account переименовано в me и теперь содержит объект Status, вместо Account (#162). • Убрано использование зарезервированных имён в аргументах конструкторов (теперь они с _ на конце). Имена с нижними подчёркиваниями есть как при сериализации так и при десериализации (#168). Крупные изменения • Добавлены аннотации типов во всей библиотеке! Незначительные изменения и/или исправления • Добавлен аргумент fetch_account_status для опциональности получения информации об акка- унте при инициализации клиента (#162). • Добавлены тесты c передачей пустого словаря в de_json и de_list (#174). • Использование ujson при наличии, обновлены зависимости (#161). • Добавлен в зависимости для разработки importlib_metadata для поддержки старых версий (в но- вой версии pytest его больше не используют, в угоду importlib.metadata #pytest-5537)) (#161). • Добавлен в зависимости для разработки atomicwrites, который используется pytest теперь толь- ко на Windows - #pytest-6148(#161). • Исправлен баг с передачей timeout аргумента в аргумент params в следующих методах: artists, albums, playlists_list (#120). • Исправлена иницилазиация клиента при помощи логина и пароля с использованием прокси (#159). • Исправлен баг в загрузке обложки альбома.

3.3 Версия 0.0.15

01.12.2019 Переломные изменения • У классов Artist, Track и Playlist изменился перечень полей для генерации хеша. Крупные изменения • Добавлена возможность выполнять запросы через прокси-сервер для использовании библиотеки на зарубежных серверах (#139).

– Добавлен пример использования в README. • Добавлена обработка капчи при авторизации с возможностью использования callback-функции для её обработки (#140):

– Новые исключения:

3.2. Версия 0.0.16 217 Yandex Music API

∗ Captcha: · CaptchaRequired. · CaptchaWrong. – Новые классы: ∗ CaptchaResponse. – Новые примеры в README: ∗ Пример обработки с использованием callback-функции. ∗ Пример полностью своей обработки капчи. • Добавлена документация для класса Search (#83). • Добавлена возможность получения всех альбомов исполнителя (#141): – Новые классы: ∗ ArtistAlbums. – Новые методы: ∗ artists_direct_albums у Client. ∗ get_albums у Artist. • Добавлена обработка несуществующего плейлиста (#147): – Новые классы: ∗ PlaylistAbsence. Незначительные изменения и/или исправления • Исправлен баг с загрузкой файлов (#149). • Исправлен баг некорректной десериализации плейлиста при отсутствии прав на него (#147). • Исправлен баг неправильной десериализации треков и артистов у собственных загруженных фай- лов (#154).

3.4 Версия 0.0.14

10.11.2019 Переломные изменения • Практически у всех классов был обновлён список полей участвующих при сравнении объектов. • Если в атрибутах для стравнения объектов присутствуют списки, то они будут преобразованы к frozenset. • Убрано конвертирование даты из строки в объект. Теперь все даты представляны строками в ISO формате. • Классы AlbumSearchResult, ArtistSearchResult, PlaylistSearchResult, TrackSearchResult, VideoSearchResult были объединены в один - SearchResult. Крупные изменения • Добавлен метод получения треков исполнителя (#123). • Добавлены классы-обёртки над пагинацией (Pager) и списка треков артиста (ArtistsTracks).

218 Глава 3. Список изменений Yandex Music API

• Добавлено 554 unit-теста для всех классов-обёрток над объектами API. • Добавлен codecov и workflows для GitHub Actions. Незначительные изменения и/или исправления • Поле cover_uri класса Album теперь опциональное. • Поле region у класса Account теперь не обязательное. • Исправлен баг в .to_dict() методе, связанный с десериализцией объектов списков и словарей. • Исправлен баг в .to_dict() методе, связанный с не рекурсивной десериализацией. • Исправлена десериализация similar_artists в BriefInfo. • Исправлен баг с десериализацией artist в классе ArtistEvent. • Исправлен баг десериализации списка альбомов и артистов у класса Track (#122). • Исправлена загрузка обложки у трека. • Исправлены сравнения объектов.

3.4. Версия 0.0.14 219 Yandex Music API

220 Глава 3. Список изменений Алфавитный указатель

Символы Account (класс в yandex_music), 52 название_эксперимента (атрибут account_experiments() (метод yandex_music.Experiments), 203 yandex_music.Client), 11 _208x208 (атрибут yandex_music.Images), 105 account_settings() (метод _300x300 (атрибут yandex_music.Images), 105 yandex_music.Client), 11 __annotations__ (атрибут account_settings_set() (метод yandex_music.YandexMusicObject), 46 yandex_music.Client), 11 __dict__ (атрибут yandex_music.YandexMusicObjectaccount_status), (атрибут 46 yandex_music.PromoCodeStatus), 207 __eq__() (метод yandex_music.YandexMusicObject),account_status() (метод yandex_music.Client), 46 12 __getitem__() (метод accountExperiments() (метод yandex_music.YandexMusicObject), 47 yandex_music.Client), 10 __hash__() (метод yandex_music.YandexMusicObjectaccountSettings()), (метод yandex_music.Client), 47 10 __metaclass__ (атрибут accountSettingsSet() (метод yandex_music.YandexMusicObject), 47 yandex_music.Client), 10 __module__ (атрибут accountStatus() (метод yandex_music.Client), 10 yandex_music.YandexMusicObject), 47 accusative (атрибут yandex_music.CaseForms), __repr__() (метод yandex_music.YandexMusicObject), 140 47 ad_params (атрибут yandex_music.StationResult), __str__() (метод yandex_music.YandexMusicObject), 162 47 ad_volume (атрибут yandex_music.AdParams), __weakref__ (атрибут 158 yandex_music.YandexMusicObject), 47 add_delete() (метод _convert_camel_to_snake() (статический ме- yandex_music.utils.difference.Difference), тод yandex_music.utils.request.Request), 196 190 add_insert() (метод _id_attrs (атрибут yandex_music.utils.difference.Difference), yandex_music.YandexMusicObject), 47 196 _object_hook() (статический метод add_new_track_on_playlist_top (атрибут yandex_music.utils.request.Request), 190 yandex_music.UserSettings), 68 _parse() (метод yandex_music.utils.request.Request),AdParams (класс в yandex_music), 158 190 ads_disabled (атрибут _request_wrapper() (метод yandex_music.UserSettings), 69 yandex_music.utils.request.Request), 191 advertisement (атрибут yandex_music.Status), 49 A after_track() (метод yandex_music.Client), 12 afterTrack() (метод yandex_music.Client), 12 account (атрибут yandex_music.Status), 49 album (атрибут yandex_music.AlbumEvent), 99

221 Yandex Music API

album (атрибут yandex_music.like.Like), 199 artistsDirectAlbums() (метод album (атрибут yandex_music.MetaData), 186 yandex_music.Client), 14 Album (класс в yandex_music), 73 artistsTracks() (метод yandex_music.Client), 14 album_id (атрибут yandex_music.TrackId), 118 ArtistTracks (класс в yandex_music), 94 album_id (атрибут yandex_music.TrackShort), auto_play_radio (атрибут 209 yandex_music.UserSettings), 68 AlbumEvent (класс в yandex_music), 99 auto_renewable (атрибут albums (атрибут yandex_music.Album), 76 yandex_music.Subscription), 56 albums (атрибут yandex_music.ArtistAlbums), 95 AutoRenewable (класс в yandex_music), 58 albums (атрибут yandex_music.BriefInfo), 92 available (атрибут yandex_music.Album), 74 albums (атрибут yandex_music.Event), 102 available (атрибут yandex_music.Artist), 85 albums (атрибут yandex_music.Search), 166 available (атрибут yandex_music.Playlist), 134 albums (атрибут yandex_music.Track), 181 available (атрибут yandex_music.Product), 62 albums() (метод yandex_music.Client), 13 available (атрибут yandex_music.Track), 181 albums_with_tracks() (метод available_as_rbt (атрибут yandex_music.Client), 13 yandex_music.Album), 76 albumsWithTracks() (метод available_as_rbt (атрибут yandex_music.Client), 13 yandex_music.Track), 182 Alert (класс в yandex_music), 70 available_for_mobile (атрибут alert_id (атрибут yandex_music.Alert), 70 yandex_music.Album), 75 alert_type (атрибут yandex_music.Alert), 70 available_for_premium_users (атрибут AlertButton (класс в yandex_music), 71 yandex_music.Album), 74 alerts (атрибут yandex_music.PermissionAlerts), available_for_premium_users (атрибут 206 yandex_music.Track), 181 aliases (атрибут yandex_music.Artist), 86 available_full_without_permission (атрибут all_covers (атрибут yandex_music.BriefInfo), 93 yandex_music.Track), 183 also_albums (атрибут yandex_music.BriefInfo), available_partially (атрибут 92 yandex_music.Album), 75 also_albums (атрибут yandex_music.Counts), 82 available_regions (атрибут also_tracks (атрибут yandex_music.Counts), 82 yandex_music.Album), 76 amount (атрибут yandex_music.Price), 64 animated_cover_uri (атрибут B yandex_music.Playlist), 136 background (атрибут yandex_music.Brand), 147 artist (атрибут yandex_music.ArtistEvent), 100 background_color (атрибут yandex_music.Icon), artist (атрибут yandex_music.BriefInfo), 92 203 artist (атрибут yandex_music.like.Like), 199 background_color (атрибут Artist (класс в yandex_music), 84 yandex_music.MixLink), 117 artist_ids (атрибут yandex_music.Vinyl), 90 background_color (атрибут ArtistAlbums (класс в yandex_music), 95 yandex_music.Playlist), 135 ArtistEvent (класс в yandex_music), 100 background_image_uri (атрибут artists (атрибут yandex_music.Album), 74 yandex_music.MixLink), 117 artists (атрибут yandex_music.Event), 102 background_video_uri (атрибут artists (атрибут yandex_music.Search), 166 yandex_music.Track), 183 artists (атрибут yandex_music.Track), 181 BadRequest (класс в yandex_music.exceptions), 49 artists() (метод yandex_music.Client), 13 bar_below (атрибут yandex_music.Status), 50 artists_brief_info() (метод base_url (атрибут yandex_music.Client),9 yandex_music.Client), 14 batch_id (атрибут yandex_music.PlaylistRecommendations), artists_direct_albums() (метод 142 yandex_music.Client), 14 batch_id (атрибут yandex_music.StationTracksResult), artists_tracks() (метод yandex_music.Client), 164 15 begin (атрибут yandex_music.PoetryLoverMatch), artistsBriefInfo() (метод 189 yandex_music.Client), 14 best (атрибут yandex_music.Search), 166 best (атрибут yandex_music.Suggestions), 165

222 Алфавитный указатель Yandex Music API

best (атрибут yandex_music.Track), 181 ChartItem (класс в yandex_music), 114 Best (класс в yandex_music), 170 cheapest (атрибут yandex_music.Product), 61 bests (атрибут yandex_music.Album), 75 client (атрибут yandex_music.Account), 53 bg_color (атрибут yandex_music.Alert), 70 client (атрибут yandex_music.AdParams), 158 bg_color (атрибут yandex_music.AlertButton), 71 client (атрибут yandex_music.Album), 76 bg_color (атрибут yandex_music.Chart), 111 client (атрибут yandex_music.AlbumEvent), 100 birthday (атрибут yandex_music.Account), 52 client (атрибут yandex_music.Alert), 71 bitrate_in_kbps (атрибут client (атрибут yandex_music.AlertButton), 72 yandex_music.DownloadInfo), 201 client (атрибут yandex_music.Artist), 86 Block (класс в yandex_music), 122 client (атрибут yandex_music.ArtistAlbums), 95 BlockEntity (класс в yandex_music), 109 client (атрибут yandex_music.ArtistEvent), 101 blocks (атрибут yandex_music.Landing), 113 client (атрибут yandex_music.ArtistTracks), 94 Brand (класс в yandex_music), 146 client (атрибут yandex_music.AutoRenewable), branding (атрибут yandex_music.Playlist), 135 58 BriefInfo (класс в yandex_music), 92 client (атрибут yandex_music.Best), 170 button (атрибут yandex_music.Alert), 70 client (атрибут yandex_music.Block), 122 button (атрибут yandex_music.Brand), 147 client (атрибут yandex_music.BlockEntity), 109 button_additional_text (атрибут client (атрибут yandex_music.Brand), 147 yandex_music.Product), 62 client (атрибут yandex_music.BriefInfo), 93 button_text (атрибут yandex_music.Product), 62 client (атрибут yandex_music.CaseForms), 140 client (атрибут yandex_music.Chart), 111 C client (атрибут yandex_music.ChartInfo), 124 cache_limit (атрибут yandex_music.Status), 50 client (атрибут yandex_music.ChartInfoMenu), can_edit (атрибут yandex_music.Contest), 145 125 can_get_more_events (атрибут client (атрибут yandex_music.ChartInfoMenuItem), yandex_music.Feed), 96 125 can_publish (атрибут yandex_music.Track), 182 client (атрибут yandex_music.ChartItem), 114 can_start_trial (атрибут client (атрибут yandex_music.Contest), 145 yandex_music.Subscription), 57 client (атрибут yandex_music.Context), 150 captcha (атрибут yandex_music.exceptions.Captcha),client (атрибут yandex_music.Counts), 82 48 client (атрибут yandex_music.Cover), 198 Captcha (класс в yandex_music.exceptions), 48 client (атрибут yandex_music.Dashboard), 159 CaptchaRequired (класс в client (атрибут yandex_music.Day), 104 yandex_music.exceptions), 48 client (атрибут yandex_music.Deactivation), 66 CaptchaResponse (класс в client (атрибут yandex_music.Deprecation), 81 yandex_music.utils.captcha_response), client (атрибут yandex_music.Description), 91 195 client (атрибут yandex_music.DiscreteScale), CaptchaWrong (класс в yandex_music.exceptions), 153 49 client (атрибут yandex_music.DownloadInfo), case_forms (атрибут yandex_music.MadeFor), 202 130 client (атрибут yandex_music.Enum), 153 CaseForms (класс в yandex_music), 140 client (атрибут yandex_music.Event), 103 category_id (атрибут yandex_music.AdParams), client (атрибут yandex_music.Experiments), 203 158 client (атрибут yandex_music.Feed), 96 chart (атрибут yandex_music.ChartInfo), 124 client (атрибут yandex_music.GeneratedPlaylist), chart (атрибут yandex_music.ChartItem), 114 99 chart (атрибут yandex_music.TrackShort), 209 client (атрибут yandex_music.Genre), 107 Chart (класс в yandex_music), 111 client (атрибут yandex_music.Icon), 204 chart() (метод yandex_music.Client), 15 client (атрибут yandex_music.Id), 154 chart_description (атрибут client (атрибут yandex_music.Images), 105 yandex_music.ChartInfo), 124 client (атрибут yandex_music.InvocationInfo), ChartInfo (класс в yandex_music), 123 205 ChartInfoMenu (класс в yandex_music), 124 client (атрибут yandex_music.Label), 80 ChartInfoMenuItem (класс в yandex_music), 125 client (атрибут yandex_music.Landing), 113

Алфавитный указатель 223 Yandex Music API

client (атрибут yandex_music.LandingList), 127 client (атрибут yandex_music.ShotData), 172 client (атрибут yandex_music.LicenceTextPart), client (атрибут yandex_music.ShotEvent), 173 188 client (атрибут yandex_music.ShotType), 174 client (атрибут yandex_music.like.Like), 200 client (атрибут yandex_music.Station), 157 client (атрибут yandex_music.Link), 83 client (атрибут yandex_music.StationData), 164 client (атрибут yandex_music.Lyrics), 176 client (атрибут yandex_music.StationResult), client (атрибут yandex_music.MadeFor), 130 163 client (атрибут yandex_music.Major), 179 client (атрибут yandex_music.StationTracksResult), client (атрибут yandex_music.MetaData), 187 164 client (атрибут yandex_music.MixLink), 117 client (атрибут yandex_music.Status), 50 client (атрибут yandex_music.NonAutoRenewable),client (атрибут yandex_music.Subscription), 57 60 client (атрибут yandex_music.Suggestions), 165 client (атрибут yandex_music.Normalization), client (атрибут yandex_music.Supplement), 175 179 client (атрибут yandex_music.Tag), 144 client (атрибут yandex_music.OpenGraphData), client (атрибут yandex_music.TagResult), 143 146 client (атрибут yandex_music.Title), 108 client (атрибут yandex_music.Operator), 65 client (атрибут yandex_music.Track), 183 client (атрибут yandex_music.Pager), 205 client (атрибут yandex_music.TrackId), 118 client (атрибут yandex_music.PassportPhone), client (атрибут yandex_music.TrackPosition), 79 54 client (атрибут yandex_music.TrackShort), 209 client (атрибут yandex_music.PermissionAlerts), client (атрибут yandex_music.TrackShortOld), 206 112 client (атрибут yandex_music.Permissions), 56 client (атрибут yandex_music.TracksList), 211 client (атрибут yandex_music.PersonalPlaylistsDataclient), (атрибут yandex_music.TrackWithAds), 97 119 client (атрибут yandex_music.User), 128 client (атрибут yandex_music.PlayContext), 115 client (атрибут yandex_music.UserSettings), 69 client (атрибут yandex_music.PlayContextsData), client (атрибут yandex_music.utils.captcha_response.CaptchaResponse), 110 195 client (атрибут yandex_music.PlayCounter), 130 client (атрибут yandex_music.utils.response.Response), client (атрибут yandex_music.Playlist), 136 194 client (атрибут yandex_music.PlaylistAbsence), client (атрибут yandex_music.Value), 160 131 client (атрибут yandex_music.Video), 213 client (атрибут yandex_music.PlaylistId), 141 client (атрибут yandex_music.VideoSupplement), client (атрибут yandex_music.PlaylistRecommendations), 177 142 client (атрибут yandex_music.Vinyl), 90 client (атрибут yandex_music.Plus), 55 Client (класс в yandex_music),9 client (атрибут yandex_music.PoetryLoverMatch), client_ (атрибут yandex_music.PlayContext), 189 115 client (атрибут yandex_music.Price), 64 close_button (атрибут yandex_music.Alert), 70 client (атрибут yandex_music.Product), 63 coauthors (атрибут yandex_music.Playlist), 135 client (атрибут yandex_music.PromoCodeStatus), codec (атрибут yandex_music.DownloadInfo), 201 207 collective (атрибут yandex_music.Playlist), 134 client (атрибут yandex_music.Promotion), 121 color (атрибут yandex_music.Genre), 107 client (атрибут yandex_music.Queue), 148 common_period_duration (атрибут client (атрибут yandex_music.QueueItem), 149 yandex_music.Product), 61 client (атрибут yandex_music.Ratings), 89 composer (атрибут yandex_music.Artist), 85 client (атрибут yandex_music.Restrictions), 161 composer (атрибут yandex_music.MetaData), 187 client (атрибут yandex_music.RotorSettings), composer_top (атрибут yandex_music.Genre), 152 106 client (атрибут yandex_music.Search), 167 concerts (атрибут yandex_music.BriefInfo), 93 client (атрибут yandex_music.SearchResult), 169 consume_promo_code() (метод client (атрибут yandex_music.Sequence), 155 yandex_music.Client), 16 client (атрибут yandex_music.Settings), 208 consumePromoCode() (метод client (атрибут yandex_music.Shot), 171 yandex_music.Client), 16

224 Алфавитный указатель Yandex Music API

content_id (атрибут yandex_music.Landing), 113 Day (класс в yandex_music), 104 content_warning (атрибут days (атрибут yandex_music.Feed), 96 yandex_music.Album), 74 db_aliases (атрибут yandex_music.Artist), 86 content_warning (атрибут yandex_music.Track), de_dict() (метод класса yandex_music.Title), 109 183 de_json() (метод класса yandex_music.Account), contest (атрибут yandex_music.Playlist), 135 53 Contest (класс в yandex_music), 144 de_json() (метод класса contest_id (атрибут yandex_music.Contest), 144 yandex_music.AdParams), 159 context (атрибут yandex_music.PlayContext), de_json() (метод класса yandex_music.Album), 115 78 context (атрибут yandex_music.Queue), 148 de_json() (метод класса context (атрибут yandex_music.QueueItem), 149 yandex_music.AlbumEvent), 100 Context (класс в yandex_music), 150 de_json() (метод класса yandex_music.Alert), 71 context_item (атрибут de_json() (метод класса yandex_music.PlayContext), 115 yandex_music.AlertButton), 72 copyright_cline (атрибут yandex_music.Cover), de_json() (метод класса yandex_music.Artist), 87 198 de_json() (метод класса copyright_name (атрибут yandex_music.Cover), yandex_music.ArtistAlbums), 95 198 de_json() (метод класса countries (атрибут yandex_music.Artist), 86 yandex_music.ArtistEvent), 101 counts (атрибут yandex_music.Artist), 85 de_json() (метод класса Counts (класс в yandex_music), 82 yandex_music.ArtistTracks), 95 cover (атрибут yandex_music.Artist), 84 de_json() (метод класса cover (атрибут yandex_music.Playlist), 133 yandex_music.AutoRenewable), 59 cover (атрибут yandex_music.Video), 212 de_json() (метод класса yandex_music.Best), 170 cover (атрибут yandex_music.VideoSupplement), de_json() (метод класса yandex_music.Block), 177 123 Cover (класс в yandex_music), 197 de_json() (метод класса cover_uri (атрибут yandex_music.Album), 74 yandex_music.BlockEntity), 110 cover_uri (атрибут yandex_music.MixLink), 117 de_json() (метод класса yandex_music.Brand), cover_uri (атрибут yandex_music.ShotData), 172 147 cover_uri (атрибут yandex_music.Track), 181 de_json() (метод класса yandex_music.BriefInfo), cover_white (атрибут yandex_music.MixLink), 94 117 de_json() (метод класса cover_without_text (атрибут yandex_music.CaseForms), 141 yandex_music.Playlist), 134 de_json() (метод класса yandex_music.Chart), created (атрибут yandex_music.Playlist), 134 112 currency (атрибут yandex_music.Price), 64 de_json() (метод класса current_index (атрибут yandex_music.Queue), yandex_music.ChartInfo), 124 148 de_json() (метод класса custom (атрибут yandex_music.Cover), 197 yandex_music.ChartInfoMenu), 125 de_json() (метод класса D yandex_music.ChartInfoMenuItem), 126 Dashboard (класс в yandex_music), 159 de_json() (метод класса dashboard_id (атрибут yandex_music.ChartItem), 114 yandex_music.Dashboard), 159 de_json() (метод класса yandex_music.Contest), data (атрибут yandex_music.Block), 122 145 data (атрибут yandex_music.GeneratedPlaylist), de_json() (метод класса yandex_music.Context), 98 151 data (атрибут yandex_music.utils.response.Response),de_json() (метод класса yandex_music.Counts), 193 82 dative (атрибут yandex_music.CaseForms), 140 de_json() (метод класса yandex_music.Cover), day (атрибут yandex_music.Day), 104 198 day (атрибут yandex_music.Ratings), 89 de_json() (метод класса

Алфавитный указатель 225 Yandex Music API

yandex_music.Dashboard), 160 yandex_music.OpenGraphData), 146 de_json() (метод класса yandex_music.Day), 104 de_json() (метод класса yandex_music.Operator), de_json() (метод класса 66 yandex_music.Deactivation), 67 de_json() (метод класса yandex_music.Pager), de_json() (метод класса 206 yandex_music.Deprecation), 81 de_json() (метод класса de_json() (метод класса yandex_music.PassportPhone), 54 yandex_music.Description), 92 de_json() (метод класса de_json() (метод класса yandex_music.PermissionAlerts), 206 yandex_music.DiscreteScale), 153 de_json() (метод класса de_json() (метод класса yandex_music.Permissions), 56 yandex_music.DownloadInfo), 202 de_json() (метод класса de_json() (метод класса yandex_music.Enum), yandex_music.PersonalPlaylistsData), 154 119 de_json() (метод класса yandex_music.Event), de_json() (метод класса 103 yandex_music.PlayContext), 116 de_json() (метод класса de_json() (метод класса yandex_music.Experiments), 203 yandex_music.PlayContextsData), 110 de_json() (метод класса yandex_music.Feed), 97 de_json() (метод класса de_json() (метод класса yandex_music.PlayCounter), 131 yandex_music.GeneratedPlaylist), 99 de_json() (метод класса yandex_music.Playlist), de_json() (метод класса yandex_music.Genre), 138 108 de_json() (метод класса de_json() (метод класса yandex_music.Icon), 204 yandex_music.PlaylistAbsence), 131 de_json() (метод класса yandex_music.Id), 154 de_json() (метод класса de_json() (метод класса yandex_music.Images), yandex_music.PlaylistId), 141 105 de_json() (метод класса de_json() (метод класса yandex_music.PlaylistRecommendations), yandex_music.InvocationInfo), 205 142 de_json() (метод класса yandex_music.Label), 80 de_json() (метод класса yandex_music.Plus), 55 de_json() (метод класса yandex_music.Landing), de_json() (метод класса 114 yandex_music.PoetryLoverMatch), 189 de_json() (метод класса de_json() (метод класса yandex_music.Price), 65 yandex_music.LandingList), 127 de_json() (метод класса yandex_music.Product), de_json() (метод класса 64 yandex_music.LicenceTextPart), 188 de_json() (метод класса de_json() (метод класса yandex_music.like.Like), yandex_music.PromoCodeStatus), 207 200 de_json() (метод класса de_json() (метод класса yandex_music.Link), 83 yandex_music.Promotion), 121 de_json() (метод класса yandex_music.Lyrics), de_json() (метод класса yandex_music.Queue), 177 149 de_json() (метод класса yandex_music.MadeFor), de_json() (метод класса 130 yandex_music.QueueItem), 149 de_json() (метод класса yandex_music.Major), de_json() (метод класса yandex_music.Ratings), 180 89 de_json() (метод класса de_json() (метод класса yandex_music.MetaData), 187 yandex_music.Restrictions), 162 de_json() (метод класса yandex_music.MixLink), de_json() (метод класса 117 yandex_music.RotorSettings), 152 de_json() (метод класса de_json() (метод класса yandex_music.Search), yandex_music.NonAutoRenewable), 60 168 de_json() (метод класса de_json() (метод класса yandex_music.Normalization), 179 yandex_music.SearchResult), 169 de_json() (метод класса de_json() (метод класса yandex_music.Sequence),

226 Алфавитный указатель Yandex Music API

155 de_json() (метод класса yandex_music.Video), de_json() (метод класса yandex_music.Settings), 213 208 de_json() (метод класса de_json() (метод класса yandex_music.Shot), 171 yandex_music.VideoSupplement), 178 de_json() (метод класса de_json() (метод класса yandex_music.Vinyl), 91 yandex_music.ShotData), 173 de_json() (метод класса de_json() (метод класса yandex_music.YandexMusicObject), 47 yandex_music.ShotEvent), 174 de_list() (метод класса yandex_music.Album), de_json() (метод класса yandex_music.ShotType), 78 174 de_list() (метод класса de_json() (метод класса yandex_music.Station), yandex_music.AlbumEvent), 100 157 de_list() (метод класса yandex_music.Artist), 88 de_json() (метод класса de_list() (метод класса yandex_music.StationData), 165 yandex_music.ArtistEvent), 101 de_json() (метод класса de_list() (метод класса yandex_music.StationResult), 163 yandex_music.AutoRenewable), 59 de_json() (метод класса de_list() (метод класса yandex_music.Block), yandex_music.StationTracksResult), 164 123 de_json() (метод класса yandex_music.Status), 51 de_list() (метод класса de_json() (метод класса yandex_music.BlockEntity), 110 yandex_music.Subscription), 57 de_list() (метод класса yandex_music.Chart), de_json() (метод класса 112 yandex_music.Suggestions), 165 de_list() (метод класса de_json() (метод класса yandex_music.ChartInfoMenuItem), 126 yandex_music.Supplement), 175 de_list() (метод класса de_json() (метод класса yandex_music.Tag), 144 yandex_music.ChartItem), 115 de_json() (метод класса de_list() (метод класса yandex_music.Cover), yandex_music.TagResult), 143 198 de_json() (метод класса yandex_music.Title), 109 de_list() (метод класса yandex_music.Day), 105 de_json() (метод класса yandex_music.Track), de_list() (метод класса 185 yandex_music.Deactivation), 67 de_json() (метод класса yandex_music.TrackId), de_list() (метод класса 119 yandex_music.DownloadInfo), 202 de_json() (метод класса de_list() (метод класса yandex_music.Event), yandex_music.TrackPosition), 79 103 de_json() (метод класса de_list() (метод класса yandex_music.TrackShort), 210 yandex_music.GeneratedPlaylist), 99 de_json() (метод класса de_list() (метод класса yandex_music.Genre), yandex_music.TrackShortOld), 113 108 de_json() (метод класса de_list() (метод класса yandex_music.Label), 80 yandex_music.TracksList), 211 de_list() (метод класса de_json() (метод класса yandex_music.LicenceTextPart), 188 yandex_music.TrackWithAds), 98 de_list() (метод класса yandex_music.like.Like), de_json() (метод класса yandex_music.User), 129 201 de_json() (метод класса de_list() (метод класса yandex_music.Link), 83 yandex_music.UserSettings), 70 de_list() (метод класса yandex_music.MixLink), de_json() (метод класса 117 yandex_music.utils.captcha_response.CaptchaResponsede_list()),(метод класса yandex_music.Operator), 195 66 de_json() (метод класса de_list() (метод класса yandex_music.utils.response.Response), yandex_music.PassportPhone), 54 194 de_list() (метод класса yandex_music.Playlist), de_json() (метод класса yandex_music.Value), 139 160 de_list() (метод класса

Алфавитный указатель 227 Yandex Music API

yandex_music.PlaylistId), 142 yandex_music.OpenGraphData), 146 de_list() (метод класса description (атрибут yandex_music.PoetryLoverMatch), 190 yandex_music.PlayCounter), 130 de_list() (метод класса yandex_music.Product), description (атрибут yandex_music.Playlist), 64 136 de_list() (метод класса description (атрибут yandex_music.Product), 62 yandex_music.Promotion), 121 Description (класс в yandex_music), 91 de_list() (метод класса description_formatted (атрибут yandex_music.QueueItem), 150 yandex_music.Playlist), 136 de_list() (метод класса yandex_music.Sequence), desired_visibility (атрибут 156 yandex_music.Track), 182 de_list() (метод класса yandex_music.Shot), 172 device (атрибут yandex_music.Client), 10 de_list() (метод класса device (атрибут yandex_music.Event), 102 yandex_music.StationResult), 163 Difference (класс в yandex_music.utils.difference), de_list() (метод класса yandex_music.Track), 196 185 dir (атрибут yandex_music.Cover), 197 de_list() (метод класса yandex_music.TrackId), direct (атрибут yandex_music.DownloadInfo), 119 201 de_list() (метод класса direct_albums (атрибут yandex_music.Counts), yandex_music.TrackShort), 210 82 de_list() (метод класса direct_link (атрибут yandex_music.TrackShortOld), 113 yandex_music.DownloadInfo), 201 de_list() (метод класса DiscreteScale (класс в yandex_music), 152 yandex_music.TrackWithAds), 98 disk_enabled (атрибут de_list() (метод класса yandex_music.User), 129 yandex_music.UserSettings), 69 de_list() (метод класса yandex_music.Value), dislike() (метод yandex_music.Album), 78 161 dislike() (метод yandex_music.Artist), 88 de_list() (метод класса yandex_music.Video), dislike() (метод yandex_music.Playlist), 139 213 dislike() (метод yandex_music.Track), 185 de_list() (метод класса display_name (атрибут yandex_music.Account), yandex_music.VideoSupplement), 178 52 de_list() (метод класса yandex_music.Vinyl), 91 display_name (атрибут yandex_music.User), 128 deactivation (атрибут yandex_music.Operator), diversity (атрибут yandex_music.Restrictions), 65 161 Deactivation (класс в yandex_music), 66 diversity (атрибут debug (атрибут yandex_music.Product), 61 yandex_music.RotorSettings), 151 decomposed (атрибут yandex_music.Artist), 85 done (атрибут yandex_music.Deprecation), 81 default (атрибут yandex_music.Permissions), 56 download() (метод yandex_music.Cover), 199 default_email (атрибут yandex_music.Status), download() (метод yandex_music.DownloadInfo), 50 202 DELETE (атрибут yandex_music.utils.difference.Operationdownload()), (метод yandex_music.Icon), 204 196 download() (метод yandex_music.Track), 185 deprecation (атрибут yandex_music.Album), 76 download() (метод yandex_music.utils.captcha_response.CaptchaResponse), Deprecation (класс в yandex_music), 81 195 description (атрибут yandex_music.Album), 74 download() (метод yandex_music.utils.request.Request), description (атрибут yandex_music.Artist), 86 191 description (атрибут yandex_music.Block), 122 download_208x208() (метод description (атрибут yandex_music.Context), yandex_music.Images), 106 150 download_300x300() (метод description (атрибут yandex_music.Images), 106 yandex_music.GeneratedPlaylist), 99 download_animated_cover() (метод description (атрибут yandex_music.like.Like), yandex_music.Playlist), 139 200 download_avatar() (метод description (атрибут yandex_music.Account), 54

228 Алфавитный указатель Yandex Music API

download_avatar() (метод yandex_music.User), 135 129 dummy_description (атрибут download_background_image() (метод yandex_music.Playlist), 135 yandex_music.MixLink), 118 dummy_page_description (атрибут download_cover() (метод yandex_music.Album), yandex_music.Playlist), 135 78 dummy_rollover_cover (атрибут download_cover() (метод yandex_music.Playlist), 135 yandex_music.ShotData), 173 duplicates (атрибут yandex_music.Album), 75 download_cover() (метод yandex_music.Track), duration (атрибут yandex_music.Product), 61 186 duration (атрибут yandex_music.Video), 212 download_info (атрибут yandex_music.Track), duration_ms (атрибут yandex_music.Album), 76 183 duration_ms (атрибут yandex_music.Playlist), download_info_url (атрибут 134 yandex_music.DownloadInfo), 201 duration_ms (атрибут yandex_music.Track), 181 download_mds() (метод yandex_music.ShotData), 173 E download_og_image() (метод embed (атрибут yandex_music.VideoSupplement), yandex_music.Album), 78 177 download_og_image() (метод embed_url (атрибут yandex_music.Video), 212 yandex_music.Artist), 88 embed_url (атрибут download_og_image() (метод yandex_music.VideoSupplement), 177 yandex_music.Playlist), 139 en_wikipedia_link (атрибут download_og_image() (метод yandex_music.Artist), 86 yandex_music.Track), 186 end (атрибут yandex_music.NonAutoRenewable), download_op_image() (метод 60 yandex_music.Artist), 88 end (атрибут yandex_music.PoetryLoverMatch), downloadAnimatedCover() (метод 189 yandex_music.Playlist), 139 end (атрибут yandex_music.Subscription), 57 downloadAvatar() (метод end_date (атрибут yandex_music.Artist), 86 yandex_music.Account), 54 energy (атрибут yandex_music.Restrictions), 161 downloadAvatar() (метод yandex_music.User), energy (атрибут yandex_music.RotorSettings), 129 151 downloadBackgroundImage() (метод entities (атрибут yandex_music.Block), 122 yandex_music.MixLink), 118 Enum (класс в yandex_music), 153 downloadCover() (метод yandex_music.Album), error (атрибут yandex_music.Album), 73 78 error (атрибут yandex_music.Artist), 84 downloadCover() (метод error (атрибут yandex_music.Cover), 198 yandex_music.ShotData), 173 error (атрибут yandex_music.Track), 182 downloadCover() (метод yandex_music.Track), error (атрибут yandex_music.utils.captcha_response.CaptchaResponse), 185 195 DownloadInfo (класс в yandex_music), 201 error (атрибут yandex_music.utils.response.Response), downloadMds() (метод yandex_music.ShotData), 194 173 error_description (атрибут downloadOgImage() (метод yandex_music.Album), yandex_music.utils.captcha_response.CaptchaResponse), 78 195 downloadOgImage() (метод yandex_music.Artist), error_description (атрибут 88 yandex_music.utils.response.Response), downloadOgImage() (метод 194 yandex_music.Playlist), 139 Event (класс в yandex_music), 102 downloadOgImage() (метод yandex_music.Track), event_id (атрибут yandex_music.ShotEvent), 173 185 events (атрибут yandex_music.Day), 104 downloadOpImage() (метод yandex_music.Artist), ever_played (атрибут yandex_music.Playlist), 88 136 dummy_cover (атрибут yandex_music.Playlist),

Алфавитный указатель 229 Yandex Music API

exec_duration_millis (атрибут full_name (атрибут yandex_music.User), 128 yandex_music.InvocationInfo), 205 full_names (атрибут yandex_music.Artist), 86 experiment (атрибут yandex_music.Status), 50 full_title (атрибут yandex_music.Genre), 107 Experiments (класс в yandex_music), 203 full_title (атрибут yandex_music.Title), 108 expires (атрибут yandex_music.AutoRenewable), 58 G explanation (атрибут gain (атрибут yandex_music.DownloadInfo), 201 yandex_music.StationResult), 162 gain (атрибут yandex_music.Normalization), 178 explicit (атрибут yandex_music.Album), 76 generate_token_by_username_and_password() explicit (атрибут yandex_music.Track), 183 (метод yandex_music.Client), 17 generated_playlist_type (атрибут F yandex_music.Playlist), 136 facebook_scrobbling_enabled (атрибут generated_playlists (атрибут yandex_music.UserSettings), 68 yandex_music.Feed), 96 family (атрибут yandex_music.Product), 61 GeneratedPlaylist (класс в yandex_music), 98 family_auto_renewable (атрибут generateTokenByUsernameAndPassword() (метод yandex_music.Subscription), 57 yandex_music.Client), 17 family_sub (атрибут yandex_music.Product), 61 genitive (атрибут yandex_music.CaseForms), fb_image (атрибут yandex_music.Product), 61 140 fb_name (атрибут yandex_music.Product), 61 genre (атрибут yandex_music.Album), 74 feature (атрибут yandex_music.Product), 61 genre (атрибут yandex_music.Event), 103 features (атрибут yandex_music.Product), 62 genre (атрибут yandex_music.MetaData), 187 Feed (класс в yandex_music), 96 Genre (класс в yandex_music), 106 feed() (метод yandex_music.Client), 16 genre_id (атрибут yandex_music.AdParams), 158 feed_wizard_is_passed() (метод genre_name (атрибут yandex_music.AdParams), yandex_music.Client), 16 158 feedWizardIsPassed() (метод genres (атрибут yandex_music.Artist), 85 yandex_music.Client), 16 genres() (метод yandex_music.Client), 18 fetch_track() (метод yandex_music.TrackShort), geocell_icon (атрибут yandex_music.Station), 210 156 fetch_tracks() (метод yandex_music.Playlist), get() (метод yandex_music.utils.request.Request), 139 192 fetchTrack() (метод yandex_music.TrackShort), get_albums() (метод yandex_music.Artist), 88 210 get_direct_link() (метод fetchTracks() (метод yandex_music.Playlist), 139 yandex_music.DownloadInfo), 202 file_size (атрибут yandex_music.Track), 182 get_download_info() (метод filename (атрибут yandex_music.Track), 182 yandex_music.Track), 186 finished (атрибут yandex_music.AutoRenewable), get_recommendations() (метод 58 yandex_music.Playlist), 139 first_name (атрибут yandex_music.Account), 52 get_supplement() (метод yandex_music.Track), from_ (атрибут yandex_music.Queue), 148 186 from_ (атрибут yandex_music.TrackId), 118 get_tracks() (метод yandex_music.Artist), 88 from_credentials() (метод класса get_url() (метод yandex_music.Icon), 204 yandex_music.Client), 17 getAlbums() (метод yandex_music.Artist), 88 from_token() (метод класса getDirectLink() (метод yandex_music.Client), 17 yandex_music.DownloadInfo), 202 fromCredentials() (метод класса getDownloadInfo() (метод yandex_music.Track), yandex_music.Client), 16 186 fromToken() (метод класса yandex_music.Client), getRecommendations() (метод 17 yandex_music.Playlist), 139 full_image_url (атрибут yandex_music.Station), getSupplement() (метод yandex_music.Track), 157 186 full_lyrics (атрибут yandex_music.Lyrics), 176 getTracks() (метод yandex_music.Artist), 88 full_name (атрибут yandex_music.Account), 52 gradient (атрибут yandex_music.Promotion), 120

230 Алфавитный указатель Yandex Music API

H ids (атрибут yandex_music.TagResult), 143 hand_made_description (атрибут image (атрибут yandex_music.Brand), 146 yandex_music.Artist), 86 image (атрибут yandex_music.OpenGraphData), handle_unknown_kwargs() (статический метод 146 yandex_music.YandexMusicObject), 47 image (атрибут yandex_music.Playlist), 134 has_info_for_app_metrica (атрибут image (атрибут yandex_music.Promotion), 121 yandex_music.Account), 53 image_url (атрибут yandex_music.Icon), 204 has_plus (атрибут yandex_music.Plus), 55 images (атрибут yandex_music.Genre), 106 has_promotions (атрибут Images (класс в yandex_music), 105 yandex_music.BriefInfo), 93 in_app_products (атрибут has_rights (атрибут yandex_music.Lyrics), 176 yandex_music.Settings), 208 heading (атрибут yandex_music.Promotion), 120 index (атрибут yandex_music.TrackPosition), 79 headlines (атрибут yandex_music.Feed), 96 init_date (атрибут yandex_music.Artist), 86 hide_in_regions (атрибут yandex_music.Genre), INSERT (атрибут yandex_music.utils.difference.Operation), 107 196 hosted_user (атрибут yandex_music.Account), 52 instructions (атрибут hostname (атрибут yandex_music.InvocationInfo), yandex_music.Deactivation), 66 204 instrumental (атрибут href (атрибут yandex_music.Link), 83 yandex_music.CaseForms), 140 html_auto_play_video_player (атрибут intro_period_duration (атрибут yandex_music.Video), 212 yandex_music.Product), 62 intro_price (атрибут yandex_music.Product), 62 I InvalidBitrate (класс в yandex_music.exceptions icon (атрибут yandex_music.Station), 156 ), 48 класс в yandex_music.exceptions Icon (класс в yandex_music), 203 InvalidToken ( ), id (атрибут yandex_music.Album), 73 48 атрибут id (атрибут yandex_music.Artist), 84 invocation_info ( yandex_music.utils.response.Response id (атрибут yandex_music.ChartInfo), 123 ), id (атрибут yandex_music.Context), 150 193 класс в yandex_music id (атрибут yandex_music.Genre), 106 InvocationInfo ( ), 204 атрибут yandex_music.Album id (атрибут yandex_music.Label), 80 is_banner ( ), 74 атрибут yandex_music.like.Like id (атрибут yandex_music.LandingList), 126 is_banner ( ), 200 атрибут yandex_music.Playlist id (атрибут yandex_music.like.Like), 199 is_banner ( ), 134 атрибут yandex_music.Cover id (атрибут yandex_music.Lyrics), 176 is_custom ( ), 197 атрибут yandex_music.Playlist id (атрибут yandex_music.Queue), 148 is_for_from ( ), id (атрибут yandex_music.QueueItem), 149 136 атрибут yandex_music.Playlist id (атрибут yandex_music.ShotType), 174 is_mine ( ), 140 атрибут yandex_music.Album id (атрибут yandex_music.Station), 156 is_premiere ( ), 74 атрибут yandex_music.like.Like id (атрибут yandex_music.Supplement), 175 is_premiere ( ), id (атрибут yandex_music.Tag), 143 200 атрибут yandex_music.Playlist id (атрибут yandex_music.Track), 180 is_premiere ( ), id (атрибут yandex_music.TrackShort), 209 134 атрибут Id (класс в yandex_music), 154 is_suitable_for_children ( yandex_music.Track id_ (атрибут yandex_music.Block), 122 ), 183 атрибут id_ (атрибут yandex_music.BlockEntity), 109 is_tutorial_completed ( yandex_music.Plus id_ (атрибут yandex_music.Event), 102 ), 55 атрибут yandex_music.Feed id_ (атрибут yandex_music.Major), 179 is_wizard_passed ( ), id_ (атрибут yandex_music.StationTracksResult), 96 атрибут 163 is_wizard_passed ( yandex_music.PersonalPlaylistsData id_ (атрибут yandex_music.TrackId), 118 ), id_for_from (атрибут yandex_music.Playlist), 119 атрибут yandex_music.Playlist 135 isMine ( ), 139 атрибут yandex_music.ChartInfoMenu id_for_from (атрибут yandex_music.Station), items ( ), 156 124

Алфавитный указатель 231 Yandex Music API

items_uri (атрибут yandex_music.Cover), 197 M made_for (атрибут yandex_music.Playlist), 133 K MadeFor (класс в yandex_music), 129 kind (атрибут yandex_music.Playlist), 133 major (атрибут yandex_music.Track), 181 kind (атрибут yandex_music.PlaylistAbsence), 131 Major (класс в yandex_music), 179 kind (атрибут yandex_music.PlaylistId), 141 master_info (атрибут yandex_music.AutoRenewable), 58 L matched_track (атрибут yandex_music.Track), Label (класс в yandex_music), 80 182 labels (атрибут yandex_music.Album), 74 max (атрибут yandex_music.DiscreteScale), 152 Landing (класс в yandex_music), 113 mcdonalds (атрибут yandex_music.Subscription), landing() (метод yandex_music.Client), 18 57 LandingList (класс в yandex_music), 126 mds_url (атрибут yandex_music.ShotData), 172 language (атрибут yandex_music.Restrictions), me (атрибут yandex_music.Client), 10 161 media (атрибут yandex_music.Vinyl), 90 language (атрибут yandex_music.RotorSettings), menu (атрибут yandex_music.ChartInfo), 124 151 message (атрибут yandex_music.Event), 102 last_fm_scrobbling_enabled (атрибут meta_data (атрибут yandex_music.Track), 182 yandex_music.UserSettings), 68 meta_type (атрибут yandex_music.Album), 75 last_owner_playlists (атрибут MetaData (класс в yandex_music), 186 yandex_music.Playlist), 136 method (атрибут yandex_music.Deactivation), 66 last_release_ids (атрибут metrika_id (атрибут yandex_music.Playlist), 135 yandex_music.BriefInfo), 92 min (атрибут yandex_music.DiscreteScale), 152 last_releases (атрибут misspell_corrected (атрибут yandex_music.BriefInfo), 92 yandex_music.Search), 167 licence_text_parts (атрибут misspell_original (атрибут yandex_music.Product), 62 yandex_music.Search), 167 LicenceTextPart (класс в yandex_music), 188 misspell_result (атрибут Like (класс в yandex_music.like), 199 yandex_music.Search), 167 like() (метод yandex_music.Album), 79 MixLink (класс в yandex_music), 116 like() (метод yandex_music.Artist), 89 modified (атрибут yandex_music.Playlist), 134 like() (метод yandex_music.Playlist), 140 modified (атрибут yandex_music.Queue), 148 like() (метод yandex_music.Track), 186 modified (атрибут yandex_music.QueueItem), liked (атрибут yandex_music.Sequence), 155 149 likes_count (атрибут yandex_music.Album), 76 modified (атрибут yandex_music.UserSettings), likes_count (атрибут yandex_music.Artist), 85 68 likes_count (атрибут yandex_music.Playlist), month (атрибут yandex_music.Ratings), 89 136 mood (атрибут yandex_music.Restrictions), 161 line (атрибут yandex_music.PoetryLoverMatch), mood (атрибут yandex_music.RotorSettings), 151 189 mood_energy (атрибут Link (класс в yandex_music), 83 yandex_music.Restrictions), 161 links (атрибут yandex_music.Artist), 85 mood_energy (атрибут listeners (атрибут yandex_music.Chart), 111 yandex_music.RotorSettings), 151 logger (атрибут yandex_music.Client),9 mts_full_image_url (атрибут login (атрибут yandex_music.Account), 52 yandex_music.Station), 157 login (атрибут yandex_music.User), 128 mts_icon (атрибут yandex_music.Station), 156 lyricist (атрибут yandex_music.MetaData), 187 lyrics (атрибут yandex_music.Lyrics), 176 N lyrics (атрибут yandex_music.Supplement), 175 name (атрибут yandex_music.Artist), 84 Lyrics (класс в yandex_music), 176 name (атрибут yandex_music.DiscreteScale), 152 lyrics_available (атрибут name (атрибут yandex_music.Enum), 153 yandex_music.Album), 76 name (атрибут yandex_music.Label), 80 lyrics_available (атрибут name (атрибут yandex_music.Major), 179 yandex_music.Track), 181 name (атрибут yandex_music.Station), 156

232 Алфавитный указатель Yandex Music API

name (атрибут yandex_music.StationData), 164 operations (атрибут name (атрибут yandex_music.Tag), 144 yandex_music.utils.difference.Difference), name (атрибут yandex_music.User), 128 196 name (атрибут yandex_music.Value), 160 operator (атрибут yandex_music.Subscription), native_products (атрибут 57 yandex_music.Settings), 208 Operator (класс в yandex_music), 65 NetworkError (класс в yandex_music.exceptions), order (атрибут yandex_music.SearchResult), 169 49 order (атрибут yandex_music.Shot), 171 new_playlists (атрибут order_id (атрибут yandex_music.AutoRenewable), yandex_music.LandingList), 127 58 new_playlists() (метод yandex_music.Client), 19 other_params (атрибут new_releases (атрибут yandex_music.AdParams), 158 yandex_music.LandingList), 126 other_tracks (атрибут new_releases() (метод yandex_music.Client), 19 yandex_music.PlayContextsData), 110 newPlaylists() (метод yandex_music.Client), 19 owner (атрибут yandex_music.Playlist), 133 newReleases() (метод yandex_music.Client), 19 next_revision (атрибут yandex_music.Feed), 96 P no_pictures_from_search (атрибут page (атрибут yandex_music.Pager), 205 yandex_music.Artist), 85 page (атрибут yandex_music.Search), 167 nocorrect (атрибут yandex_music.Search), 167 page_ref (атрибут yandex_music.AdParams), 158 nominative (атрибут yandex_music.CaseForms), pager (атрибут yandex_music.ArtistAlbums), 95 140 pager (атрибут yandex_music.ArtistTracks), 94 non_auto_renewable (атрибут Pager (класс в yandex_music), 205 yandex_music.Subscription), 57 parent_id (атрибут yandex_music.Station), 157 non_auto_renewable_remainder (атрибут partner_id (атрибут yandex_music.AdParams), yandex_music.Subscription), 56 158 NonAutoRenewable (класс в yandex_music), 59 passport_phones (атрибут normalization (атрибут yandex_music.Track), yandex_music.Account), 53 182 PassportPhone (класс в yandex_music), 54 Normalization (класс в yandex_music), 178 payment_method_types (атрибут notify (атрибут yandex_music.GeneratedPlaylist), yandex_music.Product), 62 98 payment_regularity (атрибут now (атрибут yandex_music.Account), 52 yandex_music.Operator), 65 number (атрибут yandex_music.MetaData), 187 peak (атрибут yandex_music.Normalization), 178 per_page (атрибут yandex_music.Pager), 205 O per_page (атрибут yandex_music.Search), 167 oauth_url (атрибут yandex_music.Client), 10 per_page (атрибут yandex_music.SearchResult), offer_id (атрибут yandex_music.Vinyl), 90 169 og_data (атрибут yandex_music.Playlist), 135 permission_alerts() (метод og_description (атрибут yandex_music.Playlist), yandex_music.Client), 19 134 PermissionAlerts (класс в yandex_music), 206 og_description (атрибут yandex_music.Tag), permissionAlerts() (метод 144 yandex_music.Client), 19 og_image (атрибут yandex_music.Album), 75 permissions (атрибут yandex_music.Status), 49 og_image (атрибут yandex_music.Artist), 85 Permissions (класс в yandex_music), 55 og_image (атрибут yandex_music.Playlist), 134 PersonalPlaylistsData (класс в yandex_music), og_image (атрибут yandex_music.Tag), 144 119 og_image (атрибут yandex_music.Track), 181 phone (атрибут yandex_music.Operator), 65 og_title (атрибут yandex_music.Playlist), 134 phone (атрибут yandex_music.PassportPhone), 54 op_image (атрибут yandex_music.Artist), 85 picture (атрибут yandex_music.Vinyl), 90 OpenGraphData (класс в yandex_music), 145 pixels (атрибут yandex_music.Brand), 147 Operation (класс в yandex_music.utils.difference), play_audio() (метод yandex_music.Client), 20 196 play_count (атрибут yandex_music.TrackShort), 209

Алфавитный указатель 233 Yandex Music API

play_counter (атрибут yandex_music.Playlist), prefix (атрибут yandex_music.Cover), 197 133 premium_region (атрибут yandex_music.Status), playAudio() (метод yandex_music.Client), 20 50 PlayContext (класс в yandex_music), 115 prepositional (атрибут PlayContextsData (класс в yandex_music), 110 yandex_music.CaseForms), 140 PlayCounter (класс в yandex_music), 130 prerolls (атрибут yandex_music.Album), 75 played (атрибут yandex_music.Shot), 171 prerolls (атрибут yandex_music.Playlist), 136 playlist (атрибут yandex_music.like.Like), 200 prerolls (атрибут yandex_music.StationResult), Playlist (класс в yandex_music), 132 162 playlist_absence (атрибут preview (атрибут yandex_music.DownloadInfo), yandex_music.Playlist), 133 201 playlist_id (атрибут yandex_music.Playlist), preview_duration_ms (атрибут 140 yandex_music.Track), 183 playlist_ids (атрибут yandex_music.BriefInfo), price (атрибут yandex_music.Product), 61 93 price (атрибут yandex_music.Vinyl), 90 playlist_theme (атрибут yandex_music.Brand), Price (класс в yandex_music), 64 147 product (атрибут yandex_music.AutoRenewable), playlist_uuid (атрибут yandex_music.Playlist), 58 136 Product (класс в yandex_music), 60 PlaylistAbsence (класс в yandex_music), 131 product_id (атрибут playlistId (атрибут yandex_music.Playlist), 140 yandex_music.AutoRenewable), 58 PlaylistId (класс в yandex_music), 141 product_id (атрибут yandex_music.Operator), 65 PlaylistRecommendations (класс в product_id (атрибут yandex_music.Product), 60 yandex_music), 142 progress (атрибут yandex_music.Chart), 111 playlists (атрибут yandex_music.BriefInfo), 92 promo_codes_enabled (атрибут playlists (атрибут yandex_music.Search), 166 yandex_music.Settings), 208 playlists_collective_join() (метод promo_id (атрибут yandex_music.Promotion), 120 yandex_music.Client), 21 PromoCodeStatus (класс в yandex_music), 207 playlists_list() (метод yandex_music.Client), promos_disabled (атрибут 21 yandex_music.UserSettings), 68 playlistsCollectiveJoin() (метод Promotion (класс в yandex_music), 120 yandex_music.Client), 21 provider (атрибут yandex_music.Video), 212 playlistsList() (метод yandex_music.Client), 21 provider (атрибут yandex_music.VideoSupplement), plus (атрибут yandex_music.Product), 61 177 plus (атрибут yandex_music.Status), 50 provider_video_id (атрибут Plus (класс в yandex_music), 55 yandex_music.Video), 212 podcast_episodes (атрибут provider_video_id (атрибут yandex_music.Search), 167 yandex_music.VideoSupplement), 177 podcasts (атрибут yandex_music.LandingList), pumpkin (атрибут yandex_music.Dashboard), 159 127 pumpkin (атрибут yandex_music.Feed), 96 podcasts (атрибут yandex_music.Search), 167 pumpkin (атрибут yandex_music.Landing), 113 podcasts() (метод yandex_music.Client), 22 pumpkin (атрибут yandex_music.StationTracksResult), poetry_lover_matches (атрибут 164 yandex_music.Track), 181 PoetryLoverMatch (класс в yandex_music), 189 Q popular_tracks (атрибут yandex_music.Artist), Queue (класс в yandex_music), 148 85 queue() (метод yandex_music.Client), 22 popular_tracks (атрибут queue_create() (метод yandex_music.Client), 22 yandex_music.BriefInfo), 93 queue_update_position() (метод position (атрибут yandex_music.Chart), 111 yandex_music.Client), 23 possible_values (атрибут yandex_music.Enum), queueCreate() (метод yandex_music.Client), 22 153 QueueItem (класс в yandex_music), 149 post() (метод yandex_music.utils.request.Request), queues_list() (метод yandex_music.Client), 23 192 queuesList() (метод yandex_music.Client), 23

234 Алфавитный указатель Yandex Music API

queueUpdatePosition() (метод result (атрибут yandex_music.Best), 170 yandex_music.Client), 22 result (атрибут yandex_music.utils.response.Response), 194 R results (атрибут yandex_music.SearchResult), radio_icon (атрибут yandex_music.Genre), 107 169 radio_is_available (атрибут retrieve() (метод yandex_music.utils.request.Request), yandex_music.Supplement), 175 192 ratings (атрибут yandex_music.Artist), 85 revision (атрибут yandex_music.Playlist), 133 Ratings (класс в yandex_music), 89 revision (атрибут yandex_music.TracksList), 211 rbt_disabled (атрибут rotor_account_status() (метод yandex_music.UserSettings), 68 yandex_music.Client), 25 ready (атрибут yandex_music.GeneratedPlaylist), rotor_station_feedback() (метод 98 yandex_music.Client), 25 real_id (атрибут yandex_music.Track), 181 rotor_station_feedback_radio_started() (ме- reason (атрибут yandex_music.Artist), 84 тод yandex_music.Client), 26 reason (атрибут yandex_music.PlaylistAbsence), rotor_station_feedback_skip() (метод 131 yandex_music.Client), 26 recent (атрибут yandex_music.Album), 75 rotor_station_feedback_track_finished() (ме- recent (атрибут yandex_music.TrackShort), 209 тод yandex_music.Client), 26 recent_tracks (атрибут yandex_music.Playlist), rotor_station_feedback_track_started() (ме- 135 тод yandex_music.Client), 27 reference (атрибут yandex_music.Brand), 147 rotor_station_info() (метод region (атрибут yandex_music.Account), 52 yandex_music.Client), 27 regions (атрибут yandex_music.Artist), 85 rotor_station_settings2() (метод regions (атрибут yandex_music.Playlist), 136 yandex_music.Client), 27 regions (атрибут yandex_music.Track), 182 rotor_station_tracks() (метод regions (атрибут yandex_music.User), 128 yandex_music.Client), 28 regions (атрибут yandex_music.Video), 212 rotor_stations_dashboard() (метод registered_at (атрибут yandex_music.Account), yandex_music.Client), 29 53 rotor_stations_list() (метод release_date (атрибут yandex_music.Album), 75 yandex_music.Client), 29 remember_position (атрибут rotorAccountStatus() (метод yandex_music.Album), 76 yandex_music.Client), 24 remember_position (атрибут RotorSettings (класс в yandex_music), 151 yandex_music.Track), 183 rotorStationFeedback() (метод rename() (метод yandex_music.Playlist), 140 yandex_music.Client), 24 report_new_fields (атрибут rotorStationFeedbackRadioStarted() (метод yandex_music.Client), 10 yandex_music.Client), 24 report_new_fields_callback (атрибут rotorStationFeedbackSkip() (метод yandex_music.Client), 10 yandex_music.Client), 24 report_new_fields_callback() rotorStationFeedbackTrackFinished() (метод (статический метод yandex_music.Client), 24 yandex_music.YandexMusicObject), 47 rotorStationFeedbackTrackStarted() (метод req_id (атрибут yandex_music.InvocationInfo), yandex_music.Client), 24 204 rotorStationInfo() (метод request (атрибут yandex_music.Client), 24 yandex_music.Client), 24 Request (класс в yandex_music.utils.request), 190 rotorStationsDashboard() (метод Response (класс в yandex_music.utils.response), yandex_music.Client), 25 193 rotorStationSettings2() (метод restrictions (атрибут yandex_music.Station), yandex_music.Client), 24 156 rotorStationsList() (метод Restrictions (класс в yandex_music), 161 yandex_music.Client), 25 restrictions2 (атрибут yandex_music.Station), rotorStationTracks() (метод 157 yandex_music.Client), 25

Алфавитный указатель 235 Yandex Music API

S show_translation (атрибут Search (класс в yandex_music), 166 yandex_music.Lyrics), 176 search() (метод yandex_music.Client), 29 shuffle_enabled (атрибут search_request_id (атрибут yandex_music.UserSettings), 68 yandex_music.Search), 166 similar_artists (атрибут search_suggest() (метод yandex_music.Client), yandex_music.BriefInfo), 93 30 similar_playlists (атрибут SearchResult (класс в yandex_music), 168 yandex_music.Playlist), 136 searchSuggest() (метод yandex_music.Client), 30 similar_to_artists_from_history (атрибут second_name (атрибут yandex_music.Account), 52 yandex_music.ArtistEvent), 101 selected (атрибут yandex_music.ChartInfoMenuItemskips_per_hour), (атрибут yandex_music.Status), 125 50 sent (атрибут yandex_music.Contest), 145 snapshot (атрибут yandex_music.Playlist), 133 sequence (атрибут yandex_music.StationTracksResultsocial_network), (атрибут yandex_music.Link), 83 164 start (атрибут yandex_music.NonAutoRenewable), Sequence (класс в yandex_music), 155 59 service_available (атрибут start_date (атрибут yandex_music.Album), 76 yandex_music.Account), 52 start_period_duration (атрибут set_and_return_client() (метод yandex_music.Product), 62 yandex_music.utils.request.Request), 193 start_price (атрибут yandex_music.Product), 62 set_authorization() (метод state (атрибут yandex_music.Track), 182 yandex_music.utils.request.Request), 193 station (атрибут yandex_music.StationResult), set_language() (метод 162 yandex_music.utils.request.Request), 193 Station (класс в yandex_music), 156 settings (атрибут yandex_music.StationResult), station_data (атрибут yandex_music.Status), 50 162 station_exists (атрибут yandex_music.Status), Settings (класс в yandex_music), 208 50 settings() (метод yandex_music.Client), 31 StationData (класс в yandex_music), 164 settings2 (атрибут yandex_music.StationResult), StationResult (класс в yandex_music), 162 162 stations (атрибут yandex_music.Dashboard), 159 sex (атрибут yandex_music.User), 128 StationTracksResult (класс в yandex_music), 163 shift (атрибут yandex_music.Chart), 111 status (атрибут yandex_music.Contest), 145 short_description (атрибут status (атрибут yandex_music.Deprecation), 81 yandex_music.Album), 74 status (атрибут yandex_music.PromoCodeStatus), short_description (атрибут 207 yandex_music.like.Like), 200 status (атрибут yandex_music.Shot), 171 short_description (атрибут Status (класс в yandex_music), 49 yandex_music.Track), 183 status_desc (атрибут Shot (класс в yandex_music), 171 yandex_music.PromoCodeStatus), 207 shot_data (атрибут yandex_music.Shot), 171 storage_dir (атрибут yandex_music.Album), 75 shot_id (атрибут yandex_music.Shot), 171 storage_dir (атрибут yandex_music.Track), 181 shot_text (атрибут yandex_music.ShotData), 172 sub_genres (атрибут yandex_music.Genre), 107 shot_type (атрибут yandex_music.ShotData), 172 subeditor (атрибут yandex_music.Status), 50 ShotData (класс в yandex_music), 172 subeditor_level (атрибут yandex_music.Status), ShotEvent (класс в yandex_music), 173 50 shots (атрибут yandex_music.ShotEvent), 173 subscribed (атрибут yandex_music.ArtistEvent), ShotType (класс в yandex_music), 174 101 show_disk_tracks_in_library (атрибут subscription (атрибут yandex_music.Status), 50 yandex_music.UserSettings), 69 Subscription (класс в yandex_music), 56 show_in_menu (атрибут yandex_music.Genre), substituted (атрибут yandex_music.Track), 182 106 subtitle (атрибут yandex_music.Promotion), 120 show_in_regions (атрибут yandex_music.Genre), suggestions (атрибут 106 yandex_music.Suggestions), 165 Suggestions (класс в yandex_music), 165

236 Алфавитный указатель Yandex Music API

Supplement (класс в yandex_music), 175 title (атрибут yandex_music.LandingList), 126 suspended (атрибут yandex_music.Operator), 65 title (атрибут yandex_music.Link), 83 sync_queue_enabled (атрибут title (атрибут yandex_music.MixLink), 116 yandex_music.UserSettings), 69 title (атрибут yandex_music.OpenGraphData), 146 T title (атрибут yandex_music.Operator), 65 tag (атрибут yandex_music.Id), 154 title (атрибут yandex_music.Playlist), 133 tag (атрибут yandex_music.TagResult), 143 title (атрибут yandex_music.Product), 61 Tag (класс в yandex_music), 143 title (атрибут yandex_music.Promotion), 120 TagResult (класс в yandex_music), 143 title (атрибут yandex_music.ShotType), 174 tags (атрибут yandex_music.Playlist), 133 title (атрибут yandex_music.Title), 108 tags() (метод yandex_music.Client), 31 title (атрибут yandex_music.Track), 180 target_album_id (атрибут title (атрибут yandex_music.Video), 212 yandex_music.Deprecation), 81 title (атрибут yandex_music.VideoSupplement), target_ref (атрибут yandex_music.AdParams), 177 158 title (атрибут yandex_music.Vinyl), 90 text (атрибут yandex_music.Alert), 70 Title (класс в yandex_music), 108 text (атрибут yandex_music.AlertButton), 71 titles (атрибут yandex_music.Genre), 106 text (атрибут yandex_music.Best), 170 to_dict() (метод yandex_music.YandexMusicObject), text (атрибут yandex_music.Description), 91 47 text (атрибут yandex_music.LicenceTextPart), to_json() (метод yandex_music.utils.difference.Difference), 188 197 text (атрибут yandex_music.Search), 166 to_json() (метод yandex_music.YandexMusicObject), text (атрибут yandex_music.Video), 212 48 text_color (атрибут yandex_music.Album), 74 today (атрибут yandex_music.Feed), 96 text_color (атрибут yandex_music.Alert), 70 token (атрибут yandex_music.Client),9 text_color (атрибут yandex_music.AlertButton), top_artist (атрибут yandex_music.Playlist), 135 71 total (атрибут yandex_music.Pager), 205 text_color (атрибут yandex_music.MixLink), total (атрибут yandex_music.SearchResult), 169 116 track (атрибут yandex_music.ChartItem), 114 text_color (атрибут yandex_music.Playlist), 135 track (атрибут yandex_music.Sequence), 155 text_color (атрибут yandex_music.Promotion), track (атрибут yandex_music.TrackShort), 209 120 track (атрибут yandex_music.TrackWithAds), 97 text_language (атрибут yandex_music.Lyrics), Track (класс в yandex_music), 180 176 track_count (атрибут yandex_music.Album), 73 theme (атрибут yandex_music.Brand), 147 track_count (атрибут yandex_music.Playlist), theme (атрибут yandex_music.UserSettings), 68 133 thumbnail_url (атрибут yandex_music.Video), track_id (атрибут yandex_music.Chart), 111 212 track_id (атрибут yandex_music.Track), 186 tickets_available (атрибут track_id (атрибут yandex_music.TrackId), 118 yandex_music.Artist), 85 track_id (атрибут yandex_music.TrackShort), TimedOut (класс в yandex_music.exceptions), 49 210 timestamp (атрибут yandex_music.like.Like), 199 track_id (атрибут yandex_music.TrackShortOld), timestamp (атрибут yandex_music.TrackShort), 112 209 track_position (атрибут yandex_music.Album), timestamp (атрибут 76 yandex_music.TrackShortOld), 112 track_supplement() (метод title (атрибут yandex_music.Album), 73 yandex_music.Client), 31 title (атрибут yandex_music.Block), 122 trackId (атрибут yandex_music.Track), 186 title (атрибут yandex_music.ChartInfo), 123 trackId (атрибут yandex_music.TrackShort), 210 title (атрибут yandex_music.ChartInfoMenuItem), TrackId (класс в yandex_music), 118 125 TrackPosition (класс в yandex_music), 79 title (атрибут yandex_music.Event), 102 tracks (атрибут yandex_music.AlbumEvent), 100 title (атрибут yandex_music.Genre), 106 tracks (атрибут yandex_music.ArtistEvent), 101

Алфавитный указатель 237 Yandex Music API

tracks (атрибут yandex_music.ArtistTracks), 94 type (атрибут yandex_music.Track), 181 tracks (атрибут yandex_music.Counts), 82 type (атрибут yandex_music.TrackWithAds), 97 tracks (атрибут yandex_music.Event), 102 type_ (атрибут yandex_music.Best), 170 tracks (атрибут yandex_music.PlayContext), 115 type_ (атрибут yandex_music.Block), 122 tracks (атрибут yandex_music.Playlist), 136 type_ (атрибут yandex_music.BlockEntity), 109 tracks (атрибут yandex_music.PlaylistRecommendationstype_), (атрибут yandex_music.Event), 102 142 type_ (атрибут yandex_music.Link), 83 tracks (атрибут yandex_music.Queue), 148 type_ (атрибут yandex_music.Search), 167 tracks (атрибут yandex_music.Search), 166 type_ (атрибут yandex_music.Sequence), 155 tracks (атрибут yandex_music.TracksList), 211 type_for_from (атрибут yandex_music.Block), tracks() (метод yandex_music.Client), 32 122 tracks_count (атрибут yandex_music.Event), 102 type_for_from (атрибут tracks_download_info() (метод yandex_music.ChartInfo), 123 yandex_music.Client), 32 type_for_from (атрибут yandex_music.Event), tracks_ids (атрибут yandex_music.TracksList), 102 211 type_for_from (атрибут tracks_in_chart (атрибут yandex_music.LandingList), 126 yandex_music.BriefInfo), 93 tracks_similar() (метод yandex_music.Client), U 33 uid (атрибут yandex_music.Account), 52 tracks_to_play (атрибут yandex_music.Day), uid (атрибут yandex_music.Playlist), 133 104 uid (атрибут yandex_music.PlaylistId), 141 tracks_to_play_with_ads (атрибут uid (атрибут yandex_music.TracksList), 211 yandex_music.Day), 104 uid (атрибут yandex_music.User), 128 tracksDownloadInfo() (метод uid (атрибут yandex_music.UserSettings), 68 yandex_music.Client), 32 Unauthorized (класс в yandex_music.exceptions), TrackShort (класс в yandex_music), 209 48 TrackShortOld (класс в yandex_music), 112 until (атрибут yandex_music.Permissions), 55 tracksIds (атрибут yandex_music.TracksList), updated (атрибут yandex_music.PlayCounter), 211 130 TracksList (класс в yandex_music), 211 uri (атрибут yandex_music.AlertButton), 72 tracksSimilar() (метод yandex_music.Client), 32 uri (атрибут yandex_music.Cover), 197 trackSupplement() (метод yandex_music.Client), uri (атрибут yandex_music.Description), 91 31 url (атрибут yandex_music.ChartInfoMenuItem), TrackWithAds (класс в yandex_music), 97 125 trial_available (атрибут url (атрибут yandex_music.LicenceTextPart), 188 yandex_music.Product), 62 url (атрибут yandex_music.Lyrics), 176 trial_duration (атрибут url (атрибут yandex_music.MixLink), 116 yandex_music.Product), 61 url (атрибут yandex_music.Promotion), 120 trial_period_duration (атрибут url (атрибут yandex_music.VideoSupplement), yandex_music.Product), 62 177 type (атрибут yandex_music.Album), 75 url (атрибут yandex_music.Vinyl), 90 type (атрибут yandex_music.ChartInfo), 123 url_part (атрибут yandex_music.Genre), 107 type (атрибут yandex_music.Context), 150 url_part (атрибут yandex_music.Playlist), 134 type (атрибут yandex_music.Cover), 197 url_scheme (атрибут yandex_music.MixLink), type (атрибут yandex_music.DiscreteScale), 152 116 type (атрибут yandex_music.Enum), 153 url_scheme (атрибут yandex_music.Promotion), type (атрибут yandex_music.GeneratedPlaylist), 120 98 User (класс в yandex_music), 127 type (атрибут yandex_music.Id), 154 user_info (атрибут yandex_music.MadeFor), 129 type (атрибут yandex_music.LandingList), 126 user_info (атрибут yandex_music.Track), 182 type (атрибут yandex_music.like.Like), 199 user_music_visibility (атрибут type (атрибут yandex_music.Product), 60 yandex_music.UserSettings), 68 type (атрибут yandex_music.SearchResult), 168

238 Алфавитный указатель Yandex Music API

user_social_visibility (атрибут 46 yandex_music.UserSettings), 68 usersDislikesTracks() (метод users (атрибут yandex_music.Search), 167 yandex_music.Client), 33 users_dislikes_tracks() (метод usersDislikesTracksAdd() (метод yandex_music.Client), 35 yandex_music.Client), 33 users_dislikes_tracks_add() (метод usersDislikesTracksRemove() (метод yandex_music.Client), 35 yandex_music.Client), 33 users_dislikes_tracks_remove() (метод UserSettings (класс в yandex_music), 67 yandex_music.Client), 36 usersLikesAlbums() (метод users_likes_albums() (метод yandex_music.Client), 33 yandex_music.Client), 36 usersLikesAlbumsAdd() (метод users_likes_albums_add() (метод yandex_music.Client), 33 yandex_music.Client), 37 usersLikesAlbumsRemove() (метод users_likes_albums_remove() (метод yandex_music.Client), 33 yandex_music.Client), 37 usersLikesArtists() (метод users_likes_artists() (метод yandex_music.Client), 33 yandex_music.Client), 37 usersLikesArtistsAdd() (метод users_likes_artists_add() (метод yandex_music.Client), 33 yandex_music.Client), 38 usersLikesArtistsRemove() (метод users_likes_artists_remove() (метод yandex_music.Client), 33 yandex_music.Client), 38 usersLikesPlaylists() (метод users_likes_playlists() (метод yandex_music.Client), 34 yandex_music.Client), 38 usersLikesPlaylistsAdd() (метод users_likes_playlists_add() (метод yandex_music.Client), 34 yandex_music.Client), 39 usersLikesPlaylistsRemove() (метод users_likes_playlists_remove() (метод yandex_music.Client), 34 yandex_music.Client), 39 usersLikesTracks() (метод users_likes_tracks() (метод yandex_music.Client), 34 yandex_music.Client), 40 usersLikesTracksAdd() (метод users_likes_tracks_add() (метод yandex_music.Client), 34 yandex_music.Client), 40 usersLikesTracksRemove() (метод users_likes_tracks_remove() (метод yandex_music.Client), 34 yandex_music.Client), 41 usersPlaylists() (метод yandex_music.Client), users_playlists() (метод yandex_music.Client), 34 41 usersPlaylistsChange() (метод users_playlists_change() (метод yandex_music.Client), 34 yandex_music.Client), 42 usersPlaylistsCreate() (метод users_playlists_create() (метод yandex_music.Client), 34 yandex_music.Client), 42 usersPlaylistsDelete() (метод users_playlists_delete() (метод yandex_music.Client), 34 yandex_music.Client), 43 usersPlaylistsDeleteTrack() (метод users_playlists_delete_track() (метод yandex_music.Client), 34 yandex_music.Client), 43 usersPlaylistsInsertTrack() (метод users_playlists_insert_track() (метод yandex_music.Client), 34 yandex_music.Client), 44 usersPlaylistsList() (метод users_playlists_list() (метод yandex_music.Client), 35 yandex_music.Client), 44 usersPlaylistsName() (метод users_playlists_name() (метод yandex_music.Client), 35 yandex_music.Client), 45 usersPlaylistsRecommendations() (метод users_playlists_recommendations() (метод yandex_music.Client), 35 yandex_music.Client), 45 usersPlaylistsVisibility() (метод users_playlists_visibility() (метод yandex_music.Client), 35 yandex_music.Client), 45 usersSettings() (метод yandex_music.Client), 35 users_settings() (метод yandex_music.Client),

Алфавитный указатель 239 Yandex Music API

V Y value (атрибут yandex_music.PlayCounter), 130 ya_money_id (атрибут yandex_music.Artist), 86 value (атрибут yandex_music.Tag), 143 YandexMusicError (класс в value (атрибут yandex_music.Value), 160 yandex_music.exceptions), 48 Value (класс в yandex_music), 160 YandexMusicObject (класс в yandex_music), 46 values (атрибут yandex_music.Permissions), 55 year (атрибут yandex_music.Album), 75 various (атрибут yandex_music.Artist), 84 year (атрибут yandex_music.MetaData), 187 vendor (атрибут yandex_music.AutoRenewable), year (атрибут yandex_music.Vinyl), 90 58 youtube_url (атрибут yandex_music.Video), 212 vendor_help_url (атрибут yandex_music.AutoRenewable), 58 vendor_trial_available (атрибут yandex_music.Product), 62 verified (атрибут yandex_music.User), 128 version (атрибут yandex_music.Album), 74 version (атрибут yandex_music.Cover), 197 version (атрибут yandex_music.MetaData), 187 version (атрибут yandex_music.Track), 183 very_important (атрибут yandex_music.Album), 75 Video (класс в yandex_music), 212 videos (атрибут yandex_music.BriefInfo), 93 videos (атрибут yandex_music.Search), 166 videos (атрибут yandex_music.Supplement), 175 VideoSupplement (класс в yandex_music), 177 Vinyl (класс в yandex_music), 90 vinyls (атрибут yandex_music.BriefInfo), 93 visibility (атрибут yandex_music.Playlist), 133 volume (атрибут yandex_music.MetaData), 187 volume (атрибут yandex_music.TrackPosition), 79 volume_percents (атрибут yandex_music.UserSettings), 68 volumes (атрибут yandex_music.Album), 75 W web_payment_month_product_price (атрибут yandex_music.Settings), 208 web_payment_url (атрибут yandex_music.Settings), 208 week (атрибут yandex_music.Ratings), 89 weight (атрибут yandex_music.Genre), 106 with_tracks() (метод yandex_music.Album), 79 withdrawn (атрибут yandex_music.Contest), 145 withTracks() (метод yandex_music.Album), 79 X x_captcha_key (атрибут yandex_music.utils.captcha_response.CaptchaResponse), 195 x_captcha_url (атрибут yandex_music.utils.captcha_response.CaptchaResponse), 195

240 Алфавитный указатель