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
Доступен ли альбом для пользователей с подпиской.
- 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
- 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#
- 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) – Размер обложки.
- 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#
- 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#
- withTracks(*args, **kwargs) Optional[Album] #
Псевдоним для
with_tracks
- async withTracksAsync(*args, **kwargs) Optional[Album] #
Псевдоним для
with_tracks_async
- year: Optional[int] = None#