# Album

## Атрибуты

`title` — название альбома. (`str`)

***

`subtitle` — подзаголовок альбома, во ВКонтакте отображается серым цветом справа от названия. (`str`, *optional*)

***

`fullTitle` — полное название альбома в формате `{title} ({subtitle})`. (`str`)

***

`artist` — все артисты альбома в виде строки.  (`str`)

***

`artists` — основные артисты альбома. (`list[`[`types.Artist`](https://to4no4sv.gitbook.io/vkmusix/types/artist)`]`)

***

`featuredArtists` — приглашённые артисты альбома. (`list[`[`types.Artist`](https://to4no4sv.gitbook.io/vkmusix/types/artist)`]`, *optional*)

***

`description` — описание альбома. (`str`, *optional*)

***

`releaseYear` — год выхода альбома. (`int`)

***

`genres` — жанры альбома. (`list[`[`types.Genre`](https://to4no4sv.gitbook.io/vkmusix/types/genre)`]`, *optional*)

***

`streams` — количество прослушиваний альбома. (`int`)

***

`saves` — количество сохранений альбома пользователями или группами в свою музыку. (`int`)

***

`uploadedAt` — дата и время загрузки альбома (не релиза). (`datetime`)

***

`updatedAt` — дата и время обновления альбома (не релиза). (`datetime`)

***

`exclusive` — флаг, указывающий, является ли альбом выпущенным эксклюзивно во ВКонтакте. (`bool`)

***

`mainColor` — *???*. (`str`, *optional*)

***

`photo` — словарь с ссылками на различные размеры обложки альбома, отсортированные по возрастанию. (`dict`, *optional*)

***

`original` — оригинальный альбом, если это не альбом, а плейлист, сохранённый пользователем или группой в свою музыку. ([`types.Album`](https://to4no4sv.gitbook.io/vkmusix/types/album), *optional*)

***

`trackCount` — количество треков в альбоме. (`int`)

***

`tracks` — треки альбома. Доступны при получении через [`client.getPlaylist(includeTracks=True)`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/get-playlist). (`list[`[`types.Track`](https://to4no4sv.gitbook.io/vkmusix/types/track), *optional*)

***

`ownerId` — идентификатор владельца альбома. (`int`)

***

`albumId` или `playlistId` — идентификатор альбома или плейлиста. (`int`)

***

`id` — полный идентификатор альбома в формате `{ownerId}_{albumId or playlistId}`. (`str`)

***

`url` — ссылка на альбом в формате `https://vk.com/music/album/{id}`. (`str`)

***

`raw` — необработанные данные, полученные от ВКонтакте. (`dict`)

## Получение

[`client.search()`](https://to4no4sv.gitbook.io/vkmusix/methods/search/search)

[`client.searchAlbums()`](https://to4no4sv.gitbook.io/vkmusix/methods/search/search-albums)

***

[`client.getArtistAlbums()`](https://to4no4sv.gitbook.io/vkmusix/methods/artists/get-artist-albums)

[`client.getPlaylists()`](https://to4no4sv.gitbook.io/vkmusix/methods/owners/get-playlists)

[`client.getAllPlaylists()`](https://to4no4sv.gitbook.io/vkmusix/methods/owners/get-all-playlists)

***

[`client.getPlaylist()`](https://to4no4sv.gitbook.io/vkmusix/types/playlist)

## Bound-методы

[`album.get()`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/get-playlist)

[`album.getTracks()`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/get-playlist-tracks)

[`album.add()`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/add-playlist)

[`album.remove()`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/remove-playlist)

[`album.copy()`](https://to4no4sv.gitbook.io/vkmusix/methods/playlists/copy-playlist)