This section provides the details of the content markup properties for the `MusicGroup`, `MusicAlbum`, and `MusicRecording` entity types.

## Specification table

### MusicGroup

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.googleapis.com", {"@language": "xx"}]`. - Where "xx" represents the language of the strings in the feed. Each root entity context should have it's @language set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47) format. For example, if the language is set to Spanish, the names are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `MusicGroup` for artists and groups. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The content's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - Globally unique across your catalog - Static; The ID should be stable and not change over time (even if the url property of the show changes). It will be treated as an opaque string and does not have to be a working link. - In the form of Unified Resource Identifier (URI) - The domain used for the @id value must be owned by your organization. Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the [Identifier](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#identifier) section for more details. |
| `url` | [URL](http://schema.org/URL) | **Required** - The content's [canonical URL](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#canonical_url), which Google uses to match the content in your feed to the content in Google's databases. `url` must meet the following requirements: - `url` must be globally unique - `url` must contain a working canonical URL that Google can crawl. - `url` needs to point to a content description page that is not blocked by a paywall. For playback's [deep link](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link), see the [target](https://developers.google.com/actions/media/reference/#target) object's `urlTemplate` property instead. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the artist or group. - Use an array to list the names in different languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `subjectOf` | [MusicPlaylist](http://schema.org/MusicPlaylist) | **Required for Entity-seeded Actions** - Details for the [entity-seeded action](https://developers.google.com/actions/media/collect-information/entity-types/identify-the-relationships-music). |
| `subjectOf.@type` | [Text](http://schema.org/Text) | **Required for Entity-seeded Actions** - Always set to `MusicPlaylist` for this property. |
| `subjectOf.@id` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The identifier for the entity-seeded action. See the requirements for `@id` above. It must be distinct from the `@id` for the artist/group. |
| `subjectOf.url` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The canonical URL for the entity-seeded action. See the requirements for `url` above. You can leave this out if it's the same as the `url` for the artist/group. |
| `subjectOf.potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required for Entity-seeded Actions** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `image` | [ImageObject](http://schema.org/ImageObject) | Image which represents the MusicGroup. See [Image markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#image_markup_properties). |
| `sameAs` | [URL](http://schema.org/URL) | A URL to a reference web page that can identify the artist; for example, the Wikipedia page of the artist. This must be distinct from the `url` property. |
| `description` | [Text](http://schema.org/Text) | A brief biography of the artist. 300-character limit. - Use an array to mark up the description in multiple languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `isFamilyFriendly` | [Boolean](http://schema.org/Boolean) | Indicates whether this content is family friendly (that is, the content is suitable for all members of a family, including children). Google products may use `isFamilyFriendly` when determining a song to play. |
| `popularityScore` | PopularityScoreSpecification | **Highly Recommended [Why?](https://developers.google.com/actions/media/collect-information/collect-the-metadata)** A score that Google uses, plus other signals, to determine which media to play for users. This score represents the popularity of the content in relation to other content in your catalog; therefore, the score's scale needs to be consistent across your feeds, among all the entities in your catalog. By default, an entity's popularity score is set to 0. |
| `popularityScore.@type` | [Text](http://schema.org/Text) | Always set to `PopularityScoreSpecification`. |
| `popularityScore.value` | [Number](http://schema.org/Number) | A non-negative numeric value that indicates the popularity of the entity; a higher score means higher popularity. |
| `popularityScore.eligibleRegion` | [Country](http://schema.org/Country) | Region(s) where this popularity score is applicable. If the popularity score is globally applicable, set to `EARTH`. By default, this property is set to `EARTH`. `Note: `Locale-specific popularity takes precedence over global (EARTH) popularity |

### MusicAlbum

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.googleapis.com", {"@language": "xx"}]`. - Where "xx" represents the language of the strings in the feed. Each root entity context should have it's @language set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47) format. For example, if the language is set to Spanish, the names are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `MusicAlbum` for albums. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The content's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - Globally unique across your catalog - Static; The ID should be stable and not change over time (even if the url property of the show changes). It will be treated as an opaque string and does not have to be a working link. - In the form of Unified Resource Identifier (URI) - The domain used for the @id value must be owned by your organization. Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the [Identifier](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#identifier) section for more details. |
| `url` | [URL](http://schema.org/URL) | **Required** - The content's [canonical URL](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#canonical_url), which Google uses to match the content in your feed to the content in Google's databases. `url` must meet the following requirements: - `url` must be globally unique - `url` must contain a working canonical URL that Google can crawl. - `url` needs to point to a content description page that is not blocked by a paywall. For playback's [deep link](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link), see the [target](https://developers.google.com/actions/media/reference/#target) object's `urlTemplate` property instead. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the album. - Use an array to list the names in different languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `byArtist` | [MusicGroup](http://schema.org/MusicGroup) | **Required** - The artist or group that recorded this album. At a minimum, you must specify the unique `@id` you use for that artist and the name of the artist. If the album has multiple associated artists, you may provide an array of values in byArtist. |
| `byArtist.@type` | [Text](http://schema.org/Text) | **Required** - Always set to `MusicGroup` for this property. |
| `byArtist.@id` | [URL](http://schema.org/URL) | **Required** - The identifier for the artist of the album. See the requirements for `@id` above. It must match the `@id` you use for the artist/group elsewhere in your feed. |
| `byArtist.name` | [Text](http://schema.org/Text) | **Required** - The name of the artist/group. |
| `potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `subjectOf` | [MusicPlaylist](http://schema.org/MusicPlaylist) | **Required for Entity-seeded Actions** - Details for the [entity-seeded action](https://developers.google.com/actions/media/collect-information/entity-types/identify-the-relationships-music). |
| `subjectOf.@type` | [Text](http://schema.org/Text) | **Required for Entity-seeded Actions** - Always set to `MusicPlaylist` for this property. |
| `subjectOf.@id` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The identifier for the entity-seeded action. See the requirements for `@id` above. It must be distinct from the `@id` for the album. |
| `subjectOf.url` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The canonical URL for the entity-seeded action. See the requirements for `url` above. You can leave this out if it's the same as the `url` for the album. |
| `subjectOf.potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required for Entity-seeded Actions** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `image` | [ImageObject](http://schema.org/ImageObject) | Image which represents the MusicAlbum. See [Image markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#image_markup_properties). |
| `sameAs` | [URL](http://schema.org/URL) | A URL to a reference web page that can identify the album; for example, the Wikipedia page of the album. This must be distinct from the `url` property. |
| `numTracks` | [Integer](http://schema.org/Integer) | The number of songs or tracks on this album. |
| `timeRequired` | [Text](http://schema.org/Text) | The length of the album, in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601). |
| `description` | [Text](http://schema.org/Text) | A brief description of the album. 300-character limit. - Use an array to mark up the description in multiple languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `isFamilyFriendly` | [Boolean](http://schema.org/Boolean) | Indicates whether this content is family friendly (that is, the content is suitable for all members of a family, including children). Google products may use `isFamilyFriendly` when determining a song to play. |
| `popularityScore` | PopularityScoreSpecification | A score that Google uses, plus other signals, to determine which media to play for users. This score represents the popularity of the content in relation to other content in your catalog; therefore, the score's scale needs to be consistent across your feeds, among all the entities in your catalog. By default, an entity's popularity score is set to 0. |
| `popularityScore.@type` | [Text](http://schema.org/Text) | Always set to `PopularityScoreSpecification`. |
| `popularityScore.value` | [Number](http://schema.org/Number) | A non-negative numeric value that indicates the popularity of the entity; a higher score means higher popularity. |
| `popularityScore.eligibleRegion` | [Country](http://schema.org/Country) | Region(s) where this popularity score is applicable. If the popularity score is globally applicable, set to `EARTH`. By default, this property is set to `EARTH`. |

### MusicRecording

| Property | Expected Type | Description |
|---|---|---|
| `@context` | [Text](http://schema.org/Text) | **Required** - Always set to `["http://schema.googleapis.com", {"@language": "xx"}]`. - Where "xx" represents the language of the strings in the feed. Each root entity context should have it's @language set to the appropriate language code in [BCP 47 format](http://tools.ietf.org/html/bcp47) format. For example, if the language is set to Spanish, the names are assumed to be in Spanish even if the subtitle/dub language is in English. |
| `@type` | [Text](http://schema.org/Text) | **Required** - Always set to `MusicRecording` for songs/tracks. |
| `@id` | [URL](http://schema.org/URL) | **Required** - The content's identifier in URI format; for example, *https://example.com/1234abc* . `@id` must meet the following requirements: - Globally unique across your catalog - Static; The ID should be stable and not change over time (even if the url property of the show changes). It will be treated as an opaque string and does not have to be a working link. - In the form of Unified Resource Identifier (URI) - The domain used for the @id value must be owned by your organization. Because an entity's `url` meets all the requirements as an identifier, we recommend you use an entity's `url` as `@id`. See the [Identifier](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#identifier) section for more details. |
| `url` | [URL](http://schema.org/URL) | **Required** - The content's [canonical URL](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name#canonical_url), which Google uses to match the content in your feed to the content in Google's databases. `url` must meet the following requirements: - `url` must be globally unique - `url` must contain a working canonical URL that Google can crawl. - `url` needs to point to a content description page that is not blocked by a paywall. For playback's [deep link](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link), see the [target](https://developers.google.com/actions/media/reference/#target) object's `urlTemplate` property instead. |
| `name` | [Text](http://schema.org/Text) | **Required** - The name of the song. - Use an array to list the names in different languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `byArtist` | [MusicGroup](http://schema.org/MusicGroup) | **Required** - The artist or group that recorded this song. At a minimum, you must specify the unique `@id` you use for that artist and the name of the artist. If the song has multiple associated artists, you may provide an array of values in byArtist. |
| `byArtist.@type` | [Text](http://schema.org/Text) | **Required** - Always set to `MusicGroup` for this property. |
| `byArtist.@id` | [URL](http://schema.org/URL) | **Required** - The identifier for the artist of the song. See the requirements for `@id` above. It must match the `@id` you use for the artist/group elsewhere in your feed. |
| `byArtist.name` | [Text](http://schema.org/Text) | **Required** - The name of the artist/group. |
| `potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `subjectOf` | [MusicPlaylist](http://schema.org/MusicPlaylist) | **Required for Entity-seeded Actions** - Details for the [entity-seeded action](https://developers.google.com/actions/media/collect-information/entity-types/identify-the-relationships-music) |
| `subjectOf.@type` | [Text](http://schema.org/Text) | **Required for Entity-seeded Actions** - Always set to `MusicPlaylist` for this property. |
| `subjectOf.@id` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The identifier for the entity-seeded action. See the requirements for `@id` above. It must be distinct from the `@id` for the song. |
| `subjectOf.url` | [URL](http://schema.org/URL) | **Required for Entity-seeded Actions** - The canonical URL for the entity-seeded action. See the requirements for `url` above. You can leave this out if its the same as the `url` for the song. |
| `subjectOf.potentialAction` | [ListenAction](http://schema.org/ListenAction) | **Required for Entity-seeded Actions** - An [Action markup object](https://developers.google.com/actions/media/reference/#action_markup) that provides the details of the action. See the [Action markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#action_markup_properties) for details. - Use an array to specify different [deep links](https://developers.google.com/actions/media/collect-information/identify-the-deep-links#deep_link) in multiple regions. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `image` | [ImageObject](http://schema.org/ImageObject) | Image which represents the MusicRecording. See [Image markup properties](https://developers.google.com/actions/media/reference/data-specification/listen-actions-common-specification#image_markup_properties). |
| `sameAs` | [URL](http://schema.org/URL) | A URL to a reference web page that can identify the album; for example, the Wikipedia page of the album. This must be distinct from the `url` property. |
| `inAlbum` | [MusicAlbum](http://schema.org/MusicAlbum) | The album on which the track appears, if any. |
| `inAlbum.@type` | [Text](http://schema.org/Text) | Always set to `MusicAlbum` for this property. |
| `inAlbum.@id` | [URL](http://schema.org/URL) | The identifier for the album. See the requirements for `@id` above. It must match the `@id` you use for the album elsewhere in your feed. |
| `inAlbum.name` | [Text](http://schema.org/Text) | The name of the album. |
| `duration` | [Text](http://schema.org/Text) | The length of the song, in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601). |
| `description` | [Text](http://schema.org/Text) | A brief description of the song. 300-character limit. - Use an array to mark up the description in multiple languages. See the [Multiple regions and languages](https://developers.google.com/actions/media/reference/feed-examples/listen-actions-examples#multiple_regions_and_languages) example. |
| `isFamilyFriendly` | [Boolean](http://schema.org/Boolean) | Indicates whether this content is family friendly (that is, the content is suitable for all members of a family, including children). Google products may use `isFamilyFriendly` when determining a song to play. |
| `popularityScore` | PopularityScoreSpecification | A score that Google uses, plus other signals, to determine which media to play for users. This score represents the popularity of the content in relation to other content in your catalog; therefore, the score's scale needs to be consistent across your feeds, among all the entities in your catalog. By default, an entity's popularity score is set to 0. |
| `popularityScore.@type` | [Text](http://schema.org/Text) | Always set to `PopularityScoreSpecification`. |
| `popularityScore.value` | [Number](http://schema.org/Number) | A non-negative numeric value that indicates the popularity of the entity; a higher score means higher popularity. |
| `popularityScore.eligibleRegion` | [Country](http://schema.org/Country) | Region(s) where this popularity score is applicable. If the popularity score is globally applicable, set to `EARTH`. By default, this property is set to `EARTH`. |

## Examples

### MusicGroup

    {
      "@context":["http://schema.googleapis.com/", {"@language": "en"}],
      "@type":"MusicGroup",
      "@id":"http://www.example.com/artist/my_favorite_artist/",
      "url":"http://www.example.com/artist/my_favorite_artist/",
      "sameAs": "http://www.my_favorite_artist.com",
      "name":"My Favorite Artist",
      "description":"This is my favorite artist.",
      "image":[
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["US","UK","MX"]
        },
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["UA", "IR"]
        }
      ],
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 92,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "GB"
          }
        ]
      },
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          }
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
        "url":"http://www.example.com/artist_mix/my_favorite_artist/",
        "name":"My Favorite Artist Mix",
        "description":"A playlist of songs similar to My Favorite Artist",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }

### MusicAlbum

    {
      "@context":["http://schema.googleapis.com/", {"@language": "en"}],
      "@type":"MusicAlbum",
      "@id":"http://www.example.com/album/my_favorite_album",
      "url":"http://www.example.com/album/my_favorite_album",
      "name":"My Favorite Album",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
      "description":"This is my favorite album.",
      "datePublished":"2010-08-24",
      "numTracks":"12",
      "timeRequired":"P44M02S",
      "byArtist":{
        "@type":"MusicGroup",
        "@id": "http://www.example.com/artist/my_favorite_artist/",
        "name":"My Favorite Artist"
      },
      "image":[
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["US","UK","MX"]
        },
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["UA", "IR"]
        }
      ],
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 87,
        "eligibleRegion": {
            "@type": "Country",
            "name": "US"
        }
      },
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/album/my_favorite_album?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          }
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/album_mix/my_favorite_album",
        "url":"http://www.example.com/album_mix/my_favorite_album",
        "name":"My Favorite Album Mix",
        "description":"A playlist of songs similar to My Favorite Album",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/album_mix/my_favorite_album?autoplay=true",
            "actionPlatform": [
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }

### MusicRecording

    {
      "@context":["http://schema.googleapis.com/", {"@language": "en"}],
      "@type":"MusicRecording",
      "@id":"http://www.example.com/track/my_favorite_song",
      "url":"http://www.example.com/track/my_favorite_song",
      "name":"My Favorite Song",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
      "description":"This is my favorite song.",
      "datePublished":"2010-08-24",
      "duration":"PT3M54S",
      "byArtist":{
        "@type":"MusicGroup",
        "@id": "http://www.example.com/artist/my_favorite_song/",
        "name":"My Favorite Artist"
      },
      "inAlbum":{
        "@type":"MusicAlbum",
        "@id":"http://www.example.com/album/my_favorite_album",
        "name":"My Favorite Album"
      },
      "image":[
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["US","UK","MX"]
        },
        {
          "@type": "ImageObject",
          "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
          "dateModified" : "2018-01-05T22:11:33+00:00",
          "regionsAllowed" : ["UA", "IR"]
        }
      ],
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 97,
        "eligibleRegion": "EARTH"
      },
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/track/my_favorite_song?autoplay=true",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf": {
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          }
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/track_mix/my_favorite_song",
        "url":"http://www.example.com/track_mix/my_favorite_song",
        "name":"My Favorite Song Mix",
        "description":"A playlist of songs similar to My Favorite Song",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/track_mix/my_favorite_song?autoplay=true",
            "actionPlatform": [
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }

## Related pages

Check out the following pages for the topics related to these properties:

- [Identify the entity types of your content](https://developers.google.com/actions/media/collect-information/identify-the-entity-types)
- [Collect the ID, URL, and name of your content](https://developers.google.com/actions/media/collect-information/collect-the-id-url-and-name)
- [Idenity the relationships among MusicGroup, MusicAlbum, MusicRecording, and MusicPlaylist](https://developers.google.com/actions/media/collect-information/entity-types/identify-the-relationships-music)
- [Collect the metadata of your content](https://developers.google.com/actions/media/collect-information/collect-the-metadata)