yandex_music.playlist.playlist#

Bases: YandexMusicObject

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

Note

Под полями с заглушками понимаются поля, которые доступны у умных плейлистов тогда, когда у сервиса мало данных для генерации плейлиста.

Известные значения visibility: public - публичный плейлист, private - приватный плейлист.

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

Известные значения type: missedLikes, recentTracks.

owner#

Владелец плейлиста.

Type:: yandex_music.User, optional

cover#

Обложка альбома.

Type:: yandex_music.Cover, optional

made_for#

Пользователь для которого был создан плейлист. Присутствует только у персональных плейлистов.

Type:: yandex_music.MadeFor, optional

play_counter#

Счётчик дней. Присутствует только у плейлиста дня.

Type:: yandex_music.PlayCounter, optional

playlist_absence#

Причина отсутствия плейлиста.

Type:: yandex_music.PlaylistAbsence, optional

uid#

Идентификатор владельца плейлиста.

Type:: int, optional

kind#

Идентификатор плейлиста.

Type:: int, optional

title#

Название плейлиста.

Type:: str, optional

track_count#

Количество треков.

Type:: int, optional

tags#

Список тегов плейлиста.

Type:: list, optional

revision#

Актуальность данных TODO.

Type:: int, optional

snapshot#

Версия плейлиста. Увеличивается на 1 при каждом изменении.

Type:: int, optional

visibility#

Видимость плейлиста.

Type:: str, optional

collective#

Есть ли у плейлиста соавторы.

Type:: bool, optional

url_part#

Часть ссылки на плейлист (‘daily`).

Type:: str, optional

created#

Дата создания в формате ISO 8601.

Type:: str, optional

modified#

Дата последнего изменения в формате ISO 8601.

Type:: str, optional

available#

Доступен TODO.

Type:: bool, optional

is_banner#

Является ли банером TODO.

Type:: bool, optional

is_premiere#

Является ли премьерой TODO.

Type:: bool, optional

duration_ms#

Длительность в миллисекундах.

Type:: int, optional

og_image#

Ссылка на превью Open Graph.

Type:: str, optional

og_title#

Заголовок Open Graph.

Type:: str, optional

og_description#

Описание Open Graph.

Type:: str, optional

image#

Изображение TODO.

Type:: str, optional

cover_without_text#

Обложка без текста.

Type:: yandex_music.Cover, optional

contest#

Контест TODO.

Type:: yandex_music.Contest, optional

background_color#

Цвет заднего фона TODO.

Type:: str, optional

text_color#

Цвет текста TODO.

Type:: str, optional

id_for_from#

Откуда пришло событие (уникальный идентификатор объекта) TODO.

Type:: str, optional

dummy_description#

Описание-заглушка плейлиста.

Type:: str, optional

dummy_page_description#

Описание-заглушка страницы.

Type:: str, optional

dummy_cover#

Обложка-заглушка.

Type:: str, optional

dummy_rollover_cover#

Обложка-заглушка TODO.

Type:: str, optional

og_data#

Данные для OpenGraph.

Type:: yandex_music.OpenGraphData, optional

branding#

Бренд.

Type:: yandex_music.Brand

metrika_id#

Уникальный идентификатор счётчика на Яндекс.Метрика.

Type:: int, optional

coauthors#

Перечень ID аккаунтов соавторов плейлиста.

Type:: list из int, optional

top_artist#

Топ артистов TODO.

Type:: list из yandex_music.Artist, optional

recent_tracks#

Список ID недавних треков.

Type:: list из yandex_music.TrackId, optional

tracks#

Список треков.

Type:: list из yandex_music.TrackShort, optional

prerolls#

Прерол, проигрываемый перед плейлистом. Присутствует только у персональных плейлистов.

Type:: list, optional

likes_count#

Количество лайков.

Type:: int, optional

similar_playlists#

Похожие плейлисты.

Type:: list из yandex_music.Playlist, optional

last_owner_playlists#

Последние плейлисты владельца.

Type:: list из yandex_music.Playlist, optional

generated_playlist_type#

Тип генерируемого плейлиста.

Type:: str, optional

animated_cover_uri#

Ссылка на анимированную обложку.

Type:: str, optional

ever_played#

Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO

Type:: str, optional

description#

Описание плейлиста с разметкой Markdown.

Type:: str, optional

description_formatted#

Описание плейлиста. Только текст, без разметки.

Type:: str, optional

playlist_uuid#

TODO.

Type:: str, optional

type#

TODO.

Type:: str, optional

ready#

Готовность TODO.

Type:: bool, optional

is_for_from#

TODO.

Type:: Any

regions#

Регион TODO.

Type:: Any

custom_wave (: obj:’yandex_music.CustomWave`, optional): Описание плейлиста. TODO.

pager#

Пагинатор.

Type:: yandex_music.Pager, optional

client#

Клиент Yandex Music.

Type:: yandex_music.Client, optional

animated_cover_uri: str | None = None#

available: bool | None = None#

background_color: str | None = None#

branding: Brand | None = None#

client: Client | None = None#

coauthors: List[int] = None#

collective: bool | None = None#

contest: Contest | None = None#

cover: Cover | None#

cover_without_text: Cover | None = None#

created: str | None = None#

custom_wave: CustomWave | None = None#

classmethod de_json(data: dict, client: Client) → Playlist | None#

Десериализация объекта.

Parameters:

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

Returns:

Плейлист.

Return type:

yandex_music.Playlist

classmethod de_list(data: dict, client: Client) → List[Playlist]#

Десериализация списка объектов.

Parameters:

data (list) – Список словарей с полями и значениями десериализуемого объекта.
client (yandex_music.Client, optional) – Клиент Yandex Music.

Returns:

Плейлисты.

Return type:

list из yandex_music.Playlist

delete(*args, **kwargs)#

Сокращение для:

client.users_playlists_delete(self.kind, self.owner.uid)

async deleteAsync(*args, **kwargs)#: Псевдоним для delete_async

deleteTracks(from_: int, to: int, *args, **kwargs) → Playlist | None#: Псевдоним для delete_tracks

async deleteTracksAsync(from_: int, to: int, *args, **kwargs) → Playlist | None#: Псевдоним для delete_tracks_async

async delete_async(*args, **kwargs)#

Сокращение для:

await client.users_playlists_delete(self.kind, self.owner.uid)

delete_tracks(from_: int, to: int, *args, **kwargs) → Playlist | None#

Сокращение для:

client.users_playlists_delete_track(self.kind, from_, to, self.revision, self.owner.uid, *args, **kwargs)

async delete_tracks_async(from_: int, to: int, *args, **kwargs) → Playlist | None#

Сокращение для:

await client.users_playlists_delete_track(self.kind, from_, to, self.revision, self.owner.uid, *args, **kwargs)

description: str | None = None#

description_formatted: str | None = None#

dislike(*args, **kwargs) → bool#

Сокращение для:

client.users_likes_playlists_remove(playlist.playlist_id, user.id, *args, **kwargs)

async dislikeAsync(*args, **kwargs) → bool#: Псевдоним для dislike_async

async dislike_async(*args, **kwargs) → bool#

Сокращение для:

await client.users_likes_playlists_remove(playlist.playlist_id, user.id, *args, **kwargs)

downloadAnimatedCover(filename: str, size: str = '200x200') → None#: Псевдоним для download_animated_cover

async downloadAnimatedCoverAsync(filename: str, size: str = '200x200') → None#: Псевдоним для download_animated_cover_async

downloadAnimatedCoverBytes(size: str = '200x200') → bytes#: Псевдоним для download_animated_cover_bytes

async downloadAnimatedCoverBytesAsync(size: str = '200x200') → bytes#: Псевдоним для download_animated_cover_bytes_async

downloadOgImage(filename: str, size: str = '200x200') → None#: Псевдоним для download_og_image

async downloadOgImageAsync(filename: str, size: str = '200x200') → None#: Псевдоним для download_og_image_async

downloadOgImageBytes(size: str = '200x200') → bytes#: Псевдоним для download_og_image_bytes

async downloadOgImageBytesAsync(size: str = '200x200') → bytes#: Псевдоним для download_og_image_bytes_async

download_animated_cover(filename: str, size: str = '200x200') → None#

Загрузка анимированной обложки.

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением (GIF).
size (str, optional) – Размер анимированной обложки.

async download_animated_cover_async(filename: str, size: str = '200x200') → None#

Загрузка анимированной обложки.

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением (GIF).
size (str, optional) – Размер анимированной обложки.

download_animated_cover_bytes(size: str = '200x200') → bytes#

Загрузка анимированной обложки и возврат в виде байтов.

Parameters:: size (str, optional) – Размер анимированной обложки.
Returns:: Анимированная обложка в виде байтов.
Return type:: bytes

async download_animated_cover_bytes_async(size: str = '200x200') → bytes#

Загрузка анимированной обложки и возврат в виде байтов.

Parameters:: size (str, optional) – Размер анимированной обложки.
Returns:: Анимированная обложка в виде байтов.
Return type:: bytes

download_og_image(filename: str, size: str = '200x200') → None#

Загрузка обложки.

Используйте это только когда нет self.cover!

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

async download_og_image_async(filename: str, size: str = '200x200') → None#

Загрузка обложки.

Используйте это только когда нет self.cover!

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

download_og_image_bytes(size: str = '200x200') → bytes#

Загрузка обложки и возврат в виде байтов.

Используйте это только когда нет self.cover!

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

async download_og_image_bytes_async(size: str = '200x200') → bytes#

Загрузка обложки и возврат в виде байтов.

Используйте это только когда нет self.cover!

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

dummy_cover: Cover | None = None#

dummy_description: str | None = None#

dummy_page_description: str | None = None#

dummy_rollover_cover: Cover | None = None#

duration_ms: int | None = None#

ever_played: bool | None = None#

fetchTracks(*args, **kwargs) → List[TrackShort]#: Псевдоним для fetch_tracks

async fetchTracksAsync(*args, **kwargs) → List[TrackShort]#: Псевдоним для fetch_tracks_async

fetch_tracks(*args, **kwargs) → List[TrackShort]#

Сокращение для:

client.users_playlists(playlist.kind, playlist.owner.id, *args, **kwargs).tracks

async fetch_tracks_async(*args, **kwargs) → List[TrackShort]#

Сокращение для:

await client.users_playlists(playlist.kind, playlist.owner.id, *args, **kwargs).tracks

generated_playlist_type: str | None = None#

getAnimatedCoverUrl(size: str = '300x300') → str#: Псевдоним для get_animated_cover_url

getOgImageUrl(size: str = '300x300') → str#: Псевдоним для get_og_image_url

getRecommendations(*args, **kwargs) → PlaylistRecommendations | None#: Псевдоним для get_recommendations

async getRecommendationsAsync(*args, **kwargs) → PlaylistRecommendations | None#: Псевдоним для get_recommendations_async

get_animated_cover_url(size: str = '300x300') → str#

Возвращает URL анимированной обложки.

Parameters:: size (str, optional) – Размер анимированной обложки.
Returns:: URL анимированной обложки.
Return type:: str

get_og_image_url(size: str = '300x300') → str#

Возвращает URL обложки.

Parameters:: size (str, optional) – Размер обложки.
Returns:: URL обложки.
Return type:: str

get_recommendations(*args, **kwargs) → PlaylistRecommendations | None#

Сокращение для:

client.users_playlists_recommendations(playlist.kind, playlist.owner.uid, *args, **kwargs)

async get_recommendations_async(*args, **kwargs) → PlaylistRecommendations | None#

Сокращение для:

await client.users_playlists_recommendations(playlist.kind, playlist.owner.uid, *args, **kwargs)

id_for_from: str | None = None#

image: str | None = None#

insertTrack(track_id: int, album_id: int, *args, **kwargs) → Playlist | None#: Псевдоним для insert_track

async insertTrackAsync(track_id: int, album_id: int, *args, **kwargs) → Playlist | None#: Псевдоним для insert_track_async

insert_track(track_id: int, album_id: int, *args, **kwargs) → Playlist | None#

Сокращение для:

client.users_playlists_insert_track(self.kind, track_id, album_id, user_id=self.owner.uid, revision=self.revision, *args, **kwargs)

async insert_track_async(track_id: int, album_id: int, *args, **kwargs) → Playlist | None#

Сокращение для:

await client.users_playlists_insert_track(self.kind, track_id, album_id, user_id=self.owner.uid, revision=self.revision, *args, **kwargs)

property isMine: bool#: Псевдоним для is_mine

is_banner: bool | None = None#

is_for_from: Any = None#

property is_mine: bool#

is_premiere: bool | None = None#

kind: int | None = None#

last_owner_playlists: List[Playlist] = None#

like(*args, **kwargs) → bool#

Сокращение для:

client.users_likes_playlists_add(playlist.playlist_id, user.id, *args, **kwargs)

async likeAsync(*args, **kwargs) → bool#: Псевдоним для like_async

async like_async(*args, **kwargs) → bool#

Сокращение для:

await client.users_likes_playlists_add(playlist.playlist_id, user.id, *args, **kwargs)

likes_count: int | None = None#

made_for: MadeFor | None#

metrika_id: int | None = None#

modified: str | None = None#

og_data: OpenGraphData | None = None#

og_description: str | None = None#

og_image: str | None = None#

og_title: str | None = None#

owner: User | None#

pager: Pager | None = None#

play_counter: PlayCounter | None#

property playlistId: str#: Псевдоним для playlist_id

playlist_absence: PlaylistAbsence | None#

property playlist_id: str#

playlist_uuid: str | None = None#

prerolls: list | None = None#

ready: bool | None = None#

recent_tracks: List[TrackId] = None#

regions: Any = None#

rename(name: str) → None#

async renameAsync(name: str) → None#: Псевдоним для rename_async

async rename_async(name: str) → None#

revision: int | None = None#

similar_playlists: List[Playlist] = None#

snapshot: int | None = None#

tags: list | None = None#

text_color: str | None = None#

title: str | None = None#

top_artist: List[Artist] = None#

track_count: int | None = None#

tracks: List[TrackShort] = None#

type: str | None = None#

uid: int | None = None#

url_part: str | None = None#

visibility: str | None = None#