yandex_music.album.album¶

Bases: YandexMusicObject

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

Note

Известные типы альбома: single - сингл, compilation - сборник.

Известные предупреждения о содержимом: explicit - ненормативная лексика.

Известные ошибки: not-found - альбом с таким ID не существует.

Известные значения поля meta_type: music.

Известные значения поля available_for_options: bookmate.

id¶

Идентификатор альбома.

Type:: int, optional

error¶

Ошибка получения альбома.

Type:: str, optional

title¶

Название альбома.

Type:: str, optional

track_count¶

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

Type:: int, optional

artists¶

Артисты.

Type:: list из yandex_music.Artist, optional

labels¶

Лейблы.

Type:: list из yandex_music.Label или str, optional

available¶

Доступен ли альбом.

Type:: bool, optional

available_for_premium_users¶

Доступен ли альбом для пользователей с подпиской.

Type:: bool, optional

version¶

Дополнительная информация об альбоме.

Type:: str, optional

cover_uri¶

Ссылка на обложку.

Type:: str, optional

content_warning¶

Предупреждение о содержимом альбома.

Type:: str, optional

original_release_year¶

TODO.

Type:: Any

genre¶

Жанр музыки.

Type:: str, optional

text_color¶

Цвет текста описания.

Type:: str, optional

short_description¶

Короткое описание.

Type:: str, optional

description¶

Описание.

Type:: str, optional

is_premiere¶

Премьера ли.

Type:: bool, optional

is_banner¶

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

Type:: bool, optional

meta_type¶

Мета тип TODO.

Type:: str, optional

storage_dir¶

В какой папке на сервере хранится файл TODO.

Type:: str, optional

og_image¶

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

Type:: str, optional

recent¶

Является ли альбом новым.

Type:: bool, optional

very_important¶

Популярен ли альбом у слушателей.

Type:: bool, optional

available_for_mobile¶

Доступен ли альбом из приложения для телефона.

Type:: bool, optional

available_partially¶

Доступен ли альбом частично для пользователей без подписки.

Type:: bool, optional

bests¶

ID лучших треков альбома.

Type:: list из int, optional

duplicates¶

Альбомы-дубликаты.

Type:: list из yandex_music.Album, optional

prerolls¶

Прероллы TODO.

Type:: list, optional

volumes¶

Треки альбома, разделённые по дискам.

Type:: list из list из Track, optional

year¶

Год релиза.

Type:: int, optional

release_date¶

Дата релиза в формате ISO 8601.

Type:: str, optional

type¶

Тип альбома.

Type:: str, optional

track_position¶

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

Type:: yandex_music.TrackPosition, optional

regions¶

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

Type:: list из str, optional

available_as_rbt¶

TODO.

Type:: bool, optional

lyrics_available¶

Доступны ли слова TODO.

Type:: bool, optional

remember_position¶

Запоминание позиции TODO.

Type:: bool, optional

albums¶

Альбомы TODO.

Type:: list из yandex_music.Album, optional

duration_ms¶

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

Type:: int, optional

explicit¶

Есть ли в треке ненормативная лексика.

Type:: bool, optional

start_date¶

Дата начала в формате ISO 8601 TODO.

Type:: str, optional

likes_count¶

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

Type:: int, optional

deprecation¶

TODO.

Type:: yandex_music.Deprecation, optional

available_regions¶

Регионы, где доступен альбом.

Type:: list из str, optional

available_for_options¶

Возможные опции для альбома.

Type:: list из str, optional

client¶

Клиент Yandex Music.

Type:: yandex_music.Client, optional

albums: List[Album] | None = None¶

artists: List[Artist] = None¶

artistsName() → List[str]¶: Псевдоним для artists_name

artists_name() → List[str]¶

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

Returns:: Имена исполнителей.
Return type:: list из str

available: bool | None = None¶

available_as_rbt: bool | None = None¶

available_for_mobile: bool | None = None¶

available_for_options: List[str] | None = None¶

available_for_premium_users: bool | None = None¶

available_partially: bool | None = None¶

available_regions: List[str] | None = None¶

bests: List[int] | None = None¶

buy: list | None = None¶

client: Client | None = None¶

content_warning: str | None = None¶

cover_uri: str | None = None¶

classmethod de_json(data: dict, client: Client) → Album | None¶

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

Parameters:

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

Returns:

Альбом.

Return type:

yandex_music.Album

classmethod de_list(data: list, client: Client) → List[Album]¶

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

Parameters:

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

Returns:

Альбомы.

Return type:

list из yandex_music.Album

deprecation: Deprecation | None = None¶

description: str | None = None¶

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

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

client.users_likes_albums_remove(album.id, user.id *args, **kwargs)

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

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

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

await client.users_likes_albums_remove(album.id, user.id *args, **kwargs)

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

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

downloadCoverBytes(size: str = '200x200') → bytes¶: Псевдоним для download_cover_bytes

async downloadCoverBytesAsync(size: str = '200x200') → bytes¶: Псевдоним для download_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_cover(filename: str, size: str = '200x200') → None¶

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

Parameters:

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

async download_cover_async(filename: str, size: str = '200x200') → None¶

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

Parameters:

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

download_cover_bytes(size: str = '200x200') → bytes¶

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

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

async download_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.download_cover().

Parameters:

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

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

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

Предпочтительнее использовать self.download_cover_async().

Parameters:

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

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

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

Предпочтительнее использовать self.download_cover().

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

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

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

Предпочтительнее использовать self.download_cover_async().

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

duplicates: List[Album] = None¶

duration_ms: int | None = None¶

error: str | None = None¶

explicit: bool | None = None¶

genre: str | None = None¶

getCoverUrl(size: str = '200x200') → str¶: Псевдоним для get_cover_url

getOgImageUrl(size: str = '200x200') → str¶: Псевдоним для get_og_image_url

get_cover_url(size: str = '200x200') → str¶

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

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

get_og_image_url(size: str = '200x200') → str¶

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

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

id: int | None = None¶

is_banner: bool | None = None¶

is_premiere: bool | None = None¶

labels: List[Label | str] = None¶

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

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

client.users_likes_albums_add(album.id, user.id *args, **kwargs)

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

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

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

await client.users_likes_albums_add(album.id, user.id *args, **kwargs)

likes_count: int | None = None¶

lyrics_available: bool | None = None¶

meta_type: str | None = None¶

og_image: str | None = None¶

original_release_year: Any = None¶

prerolls: list | None = None¶

recent: bool | None = None¶

regions: List[str] | None = None¶

release_date: str | None = None¶

remember_position: bool | None = None¶

short_description: str | None = None¶

start_date: str | None = None¶

storage_dir: str | None = None¶

text_color: str | None = None¶

title: str | None = None¶

track_count: int | None = None¶

track_position: TrackPosition | None = None¶

type: str | None = None¶

version: str | None = None¶

very_important: bool | None = None¶

volumes: List[List[Track]] | None = None¶

withTracks(*args, **kwargs) → Album | None¶: Псевдоним для with_tracks

async withTracksAsync(*args, **kwargs) → Album | None¶: Псевдоним для with_tracks_async

with_tracks(*args, **kwargs) → Album | None¶

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

client.albums_with_tracks(album.id, *args, **kwargs)

async with_tracks_async(*args, **kwargs) → Album | None¶

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

await client.albums_with_tracks(album.id, *args, **kwargs)

year: int | None = None¶