yandex_music.Artist

class yandex_music.Artist(id_: int, error: Optional[str] = None, reason: Optional[str] = None, name: Optional[str] = None, cover: Optional[Cover] = None, various: Optional[bool] = None, composer: Optional[bool] = None, genres: Optional[List[str]] = None, og_image: Optional[str] = None, op_image: Optional[str] = None, no_pictures_from_search=None, counts: Optional[Counts] = None, available: Optional[bool] = None, ratings: Optional[Ratings] = None, links: Optional[List[Link]] = None, tickets_available: Optional[bool] = None, likes_count: Optional[int] = None, popular_tracks: Optional[List[Track]] = None, regions: Optional[List[str]] = None, decomposed: Optional[List[Union[str, Artist]]] = None, full_names=None, hand_made_description: Optional[str] = None, description: Optional[Description] = None, countries: Optional[List[str]] = None, en_wikipedia_link: Optional[str] = None, db_aliases: Optional[List[str]] = None, aliases=None, init_date: Optional[str] = None, end_date: Optional[str] = None, client: Client = None, **kwargs)
Базовые классы: yandex_music.base.YandexMusicObject

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

id

Уникальный идентификатор.

Type:int
error

Сообщение об ошибке с объяснением почему не вернуло исполнителя.

Type:str
reason

Причина отсутствия исполнителя (сообщение об ошибке).

Type:str
name

Название.

Type:str
cover

Обложка.

Type:yandex_music.Cover | None
various

TODO.

Type:bool
composer

TODO.

Type:bool
genres

Жанры.

Type:list из str
og_image

Ссылка на изображение для Open Graph.

Type:str, optional
op_image

Ссылка на изображение обложки. Используется когда не указано поле cover.

Type:str

TODO.

counts

Счётчики.

Type:yandex_music.Counts | None
available

Доступен ли для прослушивания.

Type:bool
ratings

Рейтинги.

Type:yandex_music.Ratings | None

Ссылки на ресурсы исполнителя.

Type:list из yandex_music.Link
tickets_available

Имеются ли в продаже билеты на концерт.

Type:bool
regions

Регион TODO.

Type:list из str
decomposed

Декомпозиция всех исполнителей. Лист, где чередуется разделитель и артист. Фиты и прочее.

Type:list из str и yandex_music.Artist
popular_tracks

Популярные треки.

Type:list yandex_music.Track
likes_count

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

Type:int
full_names

TODO.

hand_made_description

Описание от Яндекс TODO.

Type:str
description

Описание.

Type:yandex_music.Description | None
countries

Страны.

Type:list из str

Адрес страницы на wikipedia.org.

Type:str
db_aliases

Другие названия. Как правило названия на разных языках.

Type:list из str
aliases

TODO.

init_date

Дата начала в формате YYYY-MM-DD или YYYY.

Type:str
end_date

Дата окончания в формате YYYY-MM-DD или YYYY.

Type:str
client

Клиент Yandex Music.

Type:yandex_music.Client
Параметры:
  • id (int) – Уникальный идентификатор.
  • error (str, optional) – Сообщение об ошибке с объяснением почему не вернуло исполнителя.
  • reason (str, optional) – Причина отсутствия исполнителя (сообщение об ошибке).
  • name (str, optional) – Название.
  • cover (yandex_music.Cover, optional) – Обложка.
  • various (bool, optional) – TODO.
  • composer (bool, optional) – TODO.
  • genres (list из str, optional) – Жанры.
  • og_image (str, optional) – Ссылка на изображение для Open Graph.
  • op_image (str, optional) – Ссылка на изображение обложки. Используется когда не указано поле cover.
  • no_pictures_from_search – TODO.
  • counts (yandex_music.Counts, optional) – Счётчики.
  • available (bool, optional) – Доступен ли для прослушивания.
  • ratings (yandex_music.Ratings, optional) – Рейтинги.
  • links (list из yandex_music.Link, optional) – Ссылки на ресурсы исполнителя.
  • tickets_available (bool, optional) – Имеются ли в продаже билеты на концерт.
  • likes_count (int, optional) – Количество лайков.
  • popular_tracks (list yandex_music.Track, optional) – Популярные треки.
  • regions (list из str, optional) – Регион TODO.
  • decomposed (list из str и yandex_music.Artist, optional) – Декомпозиция всех исполнителей. Лист, где чередуется разделитель и артист. Фиты и прочее.
  • full_names – TODO.
  • hand_made_description (str, optional) – Описание от Яндекс TODO.
  • description (yandex_music.Description, optional) – Описание.
  • countries (list из str, optional) – Страны.
  • en_wikipedia_link (str, optional) – Адрес страницы на wikipedia.org.
  • db_aliases (list из str, optional) – Другие названия. Как правило названия на разных языках.
  • aliases – TODO.
  • init_date (str, optional) – Дата начала в формате YYYY-MM-DD или YYYY.
  • end_date (str, optional) – Дата окончания в формате YYYY-MM-DD или YYYY.
  • client (yandex_music.Client) – Клиент Yandex Music.
  • **kwargs – Произвольные ключевые аргументы полученные от API.
classmethod de_json(data: dict, client: Client) → Optional[Artist]

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

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

Исполнитель.

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

yandex_music.Artist

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

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

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

Исполнители.

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

list из yandex_music.Artist

dislike(*args, **kwargs) → bool

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

client.users_likes_artists_remove(artist.id, user.id *args, **kwargs)

downloadOgImage(filename: str, size: str = '200x200') → None

Псевдоним для download_og_image

downloadOpImage(filename: str, size: str = '200x200') → None

Псевдоним для download_op_image

download_og_image(filename: str, size: str = '200x200') → None

Загрузка изображения для Open Graph.

Параметры:
  • filename (str) – Путь для сохранения файла с названием и расширением.
  • size (str, optional) – Размер обложки.
download_op_image(filename: str, size: str = '200x200') → None

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

Notes

Используйте это только когда нет self.cover!

Параметры:
  • filename (str) – Путь для сохранения файла с названием и расширением.
  • size (str, optional) – Размер обложки.
getAlbums(page=0, page_size=20, sort_by='year', *args, **kwargs) → Optional[ArtistAlbums]

Псевдоним для get_albums

getTracks(page=0, page_size=20, *args, **kwargs) → Optional[ArtistTracks]

Псевдоним для get_tracks

get_albums(page=0, page_size=20, sort_by='year', *args, **kwargs) → Optional[ArtistAlbums]

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

client.artists_direct_albums(artist.id, page, page_size, sort_by, *args, **kwargs)

get_tracks(page=0, page_size=20, *args, **kwargs) → Optional[ArtistTracks]

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

client.artists_tracks(artist.id, page, page_size, *args, **kwargs)

like(*args, **kwargs) → bool

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

client.users_likes_artists_add(artist.id, user.id *args, **kwargs)