Album

class yandex_music.album.album.Album

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

Note

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

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

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

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

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

id: intoptional

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

error: stroptional

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

title: stroptional

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

track_count: intoptional

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

artists: list из yandex_music.Artistoptional

Артисты.

labels: list из yandex_music.Label или stroptional

Лейблы.

available: booloptional

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

available_for_premium_users: booloptional

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

version: stroptional

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

cover_uri: stroptional

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

content_warning: stroptional

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

original_release_year: intoptional

Год оригинального релиза.

genre: stroptional

Жанр музыки.

text_color: stroptional

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

short_description: stroptional

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

description: stroptional

Описание.

is_premiere: booloptional

Премьера ли.

is_banner: booloptional

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

meta_type: stroptional

Мета тип TODO.

storage_dir: stroptional

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

og_image: stroptional

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

recent: booloptional

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

very_important: booloptional

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

available_for_mobile: booloptional

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

available_partially: booloptional

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

bests: list из intoptional

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

duplicates: list из yandex_music.Albumoptional

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

prerolls: listoptional

Прероллы TODO.

volumes: list из list из Trackoptional

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

year: intoptional

Год релиза.

release_date: stroptional

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

type: stroptional

Тип альбома.

track_position: yandex_music.TrackPositionoptional

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

regions: list из stroptional

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

available_as_rbt: booloptional

TODO.

lyrics_available: booloptional

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

remember_position: booloptional

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

albums: list из yandex_music.Albumoptional

Альбомы TODO.

duration_ms: intoptional

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

explicit: booloptional

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

start_date: stroptional

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

likes_count: intoptional

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

deprecation: yandex_music.Deprecationoptional

TODO.

available_regions: list из stroptional

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

available_for_options: list из stroptional

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

disclaimers: list из stroptional

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

action_button: yandex_music.AlbumActionButtonoptional

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

cover: yandex_music.Coveroptional

Обложка альбома.

derived_colors: yandex_music.CoverDerivedColorsoptional

Производные цвета обложки альбома.

meta_tag_id: stroptional

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

child_content: booloptional

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

client: yandex_music.Clientoptional

Клиент Yandex Music.

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