Export (0) Print
Expand All

Album (JSON)

A musical recording.

Album

The Album object has the following specification.

MemberTypeDescription
IdStringIdentifier for this piece of content. All IDs are of the form {namespace}.{actual identifier} and may be used in any API accepting an ID as input.
NameStringThe name of this piece of content.
ImageUrlStringA direct link to the default image associated with this piece of content. See Image Service for more information on how these links may be customized to produce different images.
LinkStringA music.xbox.com link that redirects to a contextual page for this piece of content on the relevant Xbox Music client application depending on the user's device or operating system. See Deep Link for more information on how these links work and how they should be modified for revenue sharing.
OtherIdsDictionary<string,string>An optional collection of other IDs that identify this piece of content on top of the main ID. Each key is the namespace or subnamespace in which the ID belongs, and each value is a secondary ID for this piece of content.
SourcestringAn indication of the data source for this piece of content. Possible values are Collection and Catalog.
ReleaseDateDateTimeNullable. The album release date.
DurationTimeSpanNullable. The album total duration.
TrackCountInteger.Nullable. The number of tracks on the album.
IsExplicitBooleanNullable. True if the album contains explicit content.
LabelNameStringThe name of the music label that produced this album.
GenresList of StringThe list of musical genres associated with this album.
SubgenresList of StringThe list of musical sub-genres associated with this album.
AlbumTypeStringThe type of album (for example, Album, Single, and so on).
SubtitleStringThe album subtitle.
ArtistsList of ContributorThe list of contributors (artists and their roles) to the album.
TracksList of TrackA paginated list of the album's tracks. This list is null by default unless requested as extra information in a lookup request. If not null, it should most often be full without the need to use a continuation token; only a few cases of albums containing a very large number of tracks will use pagination. Tracks in this list contain only a few fields, including the ID that should be used in a lookup request in order to have the full track properties.

Sample JSON syntax

{
  "ReleaseDate": "2013-05-09T00:00:00Z",
  "Duration": "01:14:24",
  "TrackCount": 13,
  "IsExplicit": false,
  "LabelName": "Columbia",
  "Genres": [
    "Pop"
  ],
  "Subgenres": [
    "Contemporary Pop"
  ],
  "AlbumType": "Album",
  "Artists": [
    {
      "Role": "Main",
      "Artist": {
        "Id": "music.C61C0000-0200-11DB-89CA-0019B92A3933",
        "Name": "Daft Punk",
        "ImageUrl": "http://musicimage.xboxlive.com/content/music.C61C0000-0200-11DB-89CA-0019B92A3933/image?locale=en-US",
        "Link": "http://music.xbox.com/Artist/C61C0000-0200-11DB-89CA-0019B92A3933?partnerID=AwesomePartner",
        "Source": "Catalog"
      }
    }
  ],
  "Id": "music.B13EB907-0100-11DB-89CA-0019B92A3933",
  "Name": "Random Access Memories",
  "ImageUrl": "http://musicimage.xboxlive.com/content/music.B13EB907-0100-11DB-89CA-0019B92A3933/image?locale=en-US",
  "Link": "http://music.xbox.com/Album/B13EB907-0100-11DB-89CA-0019B92A3933?partnerID=AwesomePartner",
  "OtherIds": {
    "music.amg": "R  2749955"
  },
  "Source": "Catalog"
} 
    

Community Additions

ADD
Show:
© 2014 Microsoft