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[Label] = 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, 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
track_count

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

Type:int
artists

Артисты.

Type:list из yandex_music.Artist
labels

Лейблы.

Type:list из yandex_music.Label
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

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

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
type

Тип альбома.

Type:str
track_position

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

Type:yandex_music.TrackPosition
client

Клиент Yandex Music.

Type:yandex_music.Client
Параметры:
  • id (int) – Идентификатор альбома.
  • error (str, optional) – Ошибка получения альбома.
  • title (str, optional) – Название альбома.
  • track_count (int, optional) – Количество треков.
  • artists (list из yandex_music.Artist, optional) – Артисты.
  • labels (list из yandex_music.Label, 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) – Позиция трека в альбоме. Возвращается при получении альбома в составе трека.
  • 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) – Размер обложки.
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)