Content Model

1. Every ID is its own typed message — SongID, AlbumID, EpisodeID, etc. There is no raw string or int64 ID anywhere in the public surface.
2. A single Content wrapper unifies mixed lists — used in search results, library entries, and editorial sections where the items can be of different kinds.

​

Typed IDs

message SongID    { string value = 1; }
message AlbumID   { string value = 1; }
message ArtistID  { string value = 1; }
message PlaylistID{ string value = 1; }
message ShowID    { string value = 1; }
message SeasonID  { string value = 1; }
message EpisodeID { string value = 1; }
message MovieID   { string value = 1; }

​

Music entity tree

Artist ──┐
         ├── owns ──> Album ── contains ──> Song
         └── tops ──> top tracks (Song)

Playlist ── contains ──> Song

• An artist has a discography (GetArtistDiscography), top tracks (GetArtistTopTracks), and related artists (GetRelatedArtists).
• An album has tracks (GetAlbumTracks).
• A song has lyrics, when available (GetLyrics).

​

Video entity tree

Show ── has ──> Season ── has ──> Episode
Movie (standalone)

• A show response includes season summaries for navigation.
• A season response includes its paginated episode list.
• Movies are not nested in shows.

​

The Content wrapper

message Content {
  oneof id {
    SongID song_id = 10;
    AlbumID album_id = 11;
    ArtistID artist_id = 12;
    PlaylistID playlist_id = 13;
    ShowID show_id = 14;
    SeasonID season_id = 15;
    EpisodeID episode_id = 16;
    MovieID movie_id = 17;
  }
  string title = 3;
  string subtitle = 4;
  Image artwork = 5;
}

• Search results (any of song/album/artist/playlist/show/movie).
• BrowseFeatured editorial sections.
• LibraryService.GetHistory (mixed playback history).
• BrowseGenres/GetGenreContent (genre-tagged content).

​

ContentType enum

​

Media