yandex_music.album.album#

class yandex_music.album.album.Album(id: Optional[int] = None, 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: Any = 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: Optional[List[str]] = 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)#

Bases: YandexMusicObject

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

Note

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

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

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

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

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

client#

Клиент Yandex Music.

Type

yandex_music.Client, optional

albums: Optional[List[Album]] = None#
artists: List[Artist] = None#
artistsName() List[str]#

Псевдоним для artists_name

artists_name() List[str]#

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

Returns

Имена исполнителей.

Return type

list из str

available: Optional[bool] = None#
available_as_rbt: Optional[bool] = None#
available_for_mobile: Optional[bool] = None#
available_for_premium_users: Optional[bool] = None#
available_partially: Optional[bool] = None#
available_regions: Optional[List[str]] = None#
bests: Optional[List[int]] = None#
buy: Optional[list] = None#
client: Optional[Client] = None#
content_warning: Optional[str] = None#
cover_uri: Optional[str] = None#
classmethod de_json(data: dict, client: Client) Optional[Album]#

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

Parameters
  • data (dict) – Поля и значения десериализуемого объекта.

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

Returns

Альбом.

Return type

yandex_music.Album

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

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

Parameters
  • data (list) – Список словарей с полями и значениями десериализуемого объекта.

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

Returns

Альбомы.

Return type

list из yandex_music.Album

deprecation: Optional[Deprecation] = None#
description: Optional[str] = None#
dislike(*args, **kwargs) bool#

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

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

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

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

Псевдоним для download_og_image

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

Псевдоним для download_og_image_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_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) – Размер обложки.

duplicates: List[Album] = None#
duration_ms: Optional[int] = None#
error: Optional[str] = None#
explicit: Optional[bool] = None#
genre: Optional[str] = None#
id: Optional[int] = None#
is_banner: Optional[bool] = None#
is_premiere: Optional[bool] = None#
labels: List[Union[Label, str]] = None#
like(*args, **kwargs) bool#

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

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

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

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

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

likes_count: Optional[int] = None#
lyrics_available: Optional[bool] = None#
meta_type: Optional[str] = None#
og_image: Optional[str] = None#
original_release_year: Any = None#
prerolls: Optional[list] = None#
recent: Optional[bool] = None#
regions: Optional[List[str]] = None#
release_date: Optional[str] = None#
remember_position: Optional[bool] = None#
short_description: Optional[str] = None#
start_date: Optional[str] = None#
storage_dir: Optional[str] = None#
text_color: Optional[str] = None#
title: Optional[str] = None#
track_count: Optional[int] = None#
track_position: Optional[TrackPosition] = None#
type: Optional[str] = None#
version: Optional[str] = None#
very_important: Optional[bool] = None#
volumes: Optional[List[List[Track]]] = None#
withTracks(*args, **kwargs) Optional[Album]#

Псевдоним для with_tracks

async withTracksAsync(*args, **kwargs) Optional[Album]#

Псевдоним для with_tracks_async

with_tracks(*args, **kwargs) Optional[Album]#

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

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

async with_tracks_async(*args, **kwargs) Optional[Album]#

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

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

year: Optional[int] = None#