Album

class yandex_music.album.album.Album

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

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

disclaimers

Список дисклеймеров альбома.

Type:

list из str, optional

action_button

Кнопка-действие для перехода по ссылке.

Type:

yandex_music.AlbumActionButton, optional

client

Клиент Yandex Music.

Type:

yandex_music.Client, optional

with_tracks(*args, **kwargs)

Сокращение.

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

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

Сокращение.

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

await client.albums_with_tracks(album.id, *args, **kwargs)
get_cover_url(size='200x200')

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

URL обложки.

Return type:

str

get_og_image_url(size='200x200')

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

URL обложки.

Return type:

str

download_cover(filename, size='200x200')

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

Parameters:

  • filename (str) – Путь для сохранения файла с названием и расширением.

  • size (str, optional) – Размер обложки.

async download_cover_async(filename, size='200x200')

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

Parameters:

  • filename (str) – Путь для сохранения файла с названием и расширением.

  • size (str, optional) – Размер обложки.

download_og_image(filename, size='200x200')

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

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

Parameters:

  • filename (str) – Путь для сохранения файла с названием и расширением.

  • size (str, optional) – Размер обложки.

async download_og_image_async(filename, size='200x200')

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

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

Parameters:

  • filename (str) – Путь для сохранения файла с названием и расширением.

  • size (str, optional) – Размер обложки.

download_cover_bytes(size='200x200')

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

Обложка в виде байтов.

Return type:

bytes

async download_cover_bytes_async(size='200x200')

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

Обложка в виде байтов.

Return type:

bytes

download_og_image_bytes(size='200x200')

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

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

Обложка в виде байтов.

Return type:

bytes

async download_og_image_bytes_async(size='200x200')

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

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

Parameters:

size (str, optional) – Размер обложки.

Returns:

Обложка в виде байтов.

Return type:

bytes

like(*args, **kwargs)

Сокращение.

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

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

Сокращение.

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

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

Сокращение.

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

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

Сокращение.

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

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

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

Returns:

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

Return type:

list из str

classmethod de_json(data, client)

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

Parameters:

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

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

Returns:

Альбом.

Return type:

yandex_music.Album