Лайки и дизлайки

class yandex_music._client_async.likes.LikesMixin

Лайки и дизлайки.

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

async users_likes_tracks_add(track_ids, user_id=None, **kwargs)

Поставить отметку “Мне нравится” треку/трекам.

Note

Так же снимает отметку “Не рекомендовать” если она есть.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_tracks_remove(track_ids, user_id=None, **kwargs)

Снять отметку “Мне нравится” у трека/треков.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_artists_add(artist_ids, user_id=None, **kwargs)

Поставить отметку “Мне нравится” исполнителю/исполнителям.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_artists_remove(artist_ids, user_id=None, **kwargs)

Снять отметку “Мне нравится” у исполнителя/исполнителей.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_playlists_add(playlist_ids, user_id=None, **kwargs)

Поставить отметку “Мне нравится” плейлисту/плейлистам.

Note

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

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_playlists_remove(playlist_ids, user_id=None, **kwargs)

Снять отметку “Мне нравится” у плейлиста/плейлистов.

Note

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

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_albums_add(album_ids, user_id=None, **kwargs)

Поставить отметку “Мне нравится” альбому/альбомам.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_albums_remove(album_ids, user_id=None, **kwargs)

Снять отметку “Мне нравится” у альбома/альбомов.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_tracks(user_id=None, if_modified_since_revision=0, *args, **kwargs)

Получение треков с отметкой “Мне нравится”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

• if_modified_since_revision (int, optional) – TODO.

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

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

Returns:

Треки с отметкой “Мне нравится”.

Return type:

yandex_music.TracksList

Raises:

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

async users_likes_albums(user_id=None, rich=True, *args, **kwargs)

Получение альбомов с отметкой “Мне нравится”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

• rich (bool, optional) – Если False, то приходит укороченная версия.

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

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

Returns:

Альбомы с отметкой “Мне нравится”.

Return type:

list из yandex_music.Like

Raises:

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

async users_likes_artists(user_id=None, with_timestamps=True, *args, **kwargs)

Получение артистов с отметкой “Мне нравится”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

• with_timestamps (bool, optional) – С временными метками TODO.

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

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

Returns:

Артисты с отметкой “Мне нравится”.

Return type:

list из yandex_music.Like

Raises:

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

async users_likes_playlists(user_id=None, *args, **kwargs)

Получение плейлистов с отметкой “Мне нравится”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

Плейлисты с отметкой “Мне нравится”.

Return type:

list из yandex_music.Like

Raises:

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

async users_dislikes_tracks(user_id=None, if_modified_since_revision=0, *args, **kwargs)

Получение треков с отметкой “Не рекомендовать”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

• if_modified_since_revision (bool, optional) – TODO.

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

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

Returns:

Треки с отметкой “Не рекомендовать”.

Return type:

list из yandex_music.TracksList

Raises:

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

async users_dislikes_tracks_add(track_ids, user_id=None, **kwargs)

Поставить отметку “Не рекомендовать” треку/трекам.

Note

Так же снимает отметку “Мне нравится” если она есть.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_dislikes_tracks_remove(track_ids, user_id=None, **kwargs)

Снять отметку “Не рекомендовать” у трека/треков.

Parameters:

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

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_dislikes_artists(user_id=None, *args, **kwargs)

Получение исполнителей с отметкой “Не рекомендовать”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

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

Returns:

Исполнители с отметкой “Не рекомендовать”.

Return type:

list из yandex_music.Artist

Raises:

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

async users_dislikes_artists_add(artist_id, user_id=None, **kwargs)

Поставить отметку “Не рекомендовать” исполнителю.

Note

Так же снимает отметку “Мне нравится” если она есть.

Parameters:

• artist_id (str | int) – Уникальный идентификатор исполнителя.

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_dislikes_artists_remove(artist_id, user_id=None, **kwargs)

Снять отметку “Не рекомендовать” у исполнителя.

Parameters:

• artist_id (str | int) – Уникальный идентификатор исполнителя.

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_clips(user_id=None, page=0, page_size=100, *args, **kwargs)

Получение клипов с отметкой “Мне нравится”.

Parameters:

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

• page (int, optional) – Номер страницы.

• page_size (int, optional) – Количество элементов на странице.

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

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

Returns:

Клипы с отметкой “Мне нравится”.

Return type:

yandex_music.ClipsWillLike

Raises:

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

async users_likes_clips_add(clip_id, user_id=None, **kwargs)

Поставить отметку “Мне нравится” клипу.

Parameters:

• clip_id (str | int) – Уникальный идентификатор клипа.

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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

async users_likes_clips_remove(clip_id, user_id=None, **kwargs)

Снять отметку “Мне нравится” у клипа.

Parameters:

• clip_id (str | int) – Уникальный идентификатор клипа.

• user_id (str | int, optional) – Уникальный идентификатор пользователя. Если не указан используется ID текущего пользователя.

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

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

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