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, 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, 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 не существует.

id

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

Type:int
error

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

Type:str
title

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

Type:str
track_count

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

Type:int
artists

Список объектов класса yandex_music.Artist представляющие артистов.

Type:list из yandex_music.Artist
labels

Список объектов класса yandex_music.Label представляющие лейблы.

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
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
volumes

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

Type:list из list из Track
year

Год релиза.

Type:int
release_date

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

Type:str
type

Тип альбома.

Type:str
track_position

Объект класса yandex_music.TrackPosition представляющий позицию трека. Возвращается при получении альбома в составе трека.

Type:yandex_music.TrackPosition
client

Объект класса yandex_music.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) – Список объектов класса yandex_music.Artist представляющие артистов.
  • labels (list из yandex_music.Label, optional) – Список объектов класса yandex_music.Label представляющие лейблы.
  • available (bool, optional) – Доступен ли альбом.
  • available_for_premium_users (bool, optional) – Доступен ли альбом для пользователей с подпиской.
  • version (str, optional) – Дополнительная информация об альбоме.
  • cover_uri (str, optional) – Ссылка на обложку.
  • content_warning (str, optional) – Предупреждение о содержимом альбома.
  • genre (str, optional) – Жанр музыки.
  • 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 лучших треков альбома.
  • volumes (list из list из Track, optional) – Треки альбома, разделенные по дискам.
  • year (int, optional) – Год релиза.
  • release_date (str, optional) – Дата релиза в формате ISO 8601.
  • type (str, optional) – Тип альбома.
  • track_position (yandex_music.TrackPosition, optional) – Объект класса yandex_music.TrackPosition представляющий позицию трека. Возвращается при получении альбома в составе трека.
  • client (yandex_music.Client, optional) – Объект класса yandex_music.Client, представляющий клиент Yandex Music.
  • **kwargs – Произвольные ключевые аргументы полученные от API.
classmethod de_json(data: dict, client: Client) → Optional[Album]

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

Параметры:
  • data (dict) – Поля и значения десериализуемого объекта.
  • client (yandex_music.Client) – Объект класса yandex_music.Client, представляющий клиент Yandex Music.
Результат:

Объект класса yandex_music.Album.

Тип результата:

yandex_music.Album

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

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

Параметры:
  • data (list) – Список словарей с полями и значениями десериализуемого объекта.
  • client (yandex_music.Client) – Объект класса yandex_music.Client, представляющий клиент Yandex Music.
Результат:

Список объектов класса yandex_music.Album.

Тип результата:

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)