音乐人、专辑和歌曲的内容标记属性

本部分详细介绍了 MusicGroup、MusicAlbum 和 MusicRecording 实体类型的内容标记属性。

规范表

MusicGroup

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
@type 文本 必需 - 对于音乐人和乐队，始终设置为 MusicGroup。
@id 网址 必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在您的目录中具有全局唯一性
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。
  • 以统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归您的组织所有。
由于实体的 url 符合作为标识符的所有要求，因此我们建议您使用实体的 url 作为 @id。如需了解详情，请参阅标识符部分。
url 网址 必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。
url 必须满足以下要求：
  • url 必须是全局唯一的
  • url 必须包含 Google 可以抓取的有效规范网址。
  • url 需要指向未被付费墙屏蔽的内容说明网页。
如需了解播放的深层链接，请参阅 target 对象的 urlTemplate 属性。
name 文本 必需 - 音乐人或乐队的名称。
potentialAction ListenAction 必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。
subjectOf MusicPlaylist 对于实体种子操作是必需的 - 实体种子操作的详细信息。
subjectOf.@type 文本 对于实体种子操作是必需的 - 此属性始终设置为 MusicPlaylist。
subjectOf.@id 网址 对于实体种子操作是必需的 - 实体种子操作的标识符。请参阅上文的 @id 要求。必须与艺术家/团体的 @id 不同。
subjectOf.url 网址 对于实体种子操作是必需的 - 实体种子操作的规范网址。请参阅上文的 url 要求。如果与相应音乐人/团体的 url 相同，则可以省略。
subjectOf.potentialAction ListenAction 实体种子 Action 必需 - 提供 Action 详细信息的 Action 标记对象。如需了解详情，请参阅操作标记属性。
image ImageObject 表示 MusicGroup 的图片。请参阅图片标记属性。
sameAs 网址 可标识音乐人的参考网页的网址；例如，音乐人的维基百科页面。此值必须与 url 属性不同。
description 文本 音乐人的简短个人简介。300 个字符。
isFamilyFriendly 布尔值 表示相应内容是否适合全家观看（即内容是否适合家庭中的所有成员，包括儿童）。Google 产品可能会使用 isFamilyFriendly 来确定要播放的歌曲。
popularityScore PopularityScoreSpecification 强烈推荐 为什么？Google 使用的一种分数，用于与其他信号一起确定要为用户播放哪些媒体内容。此得分表示相应内容相对于您目录中其他内容的受欢迎程度；因此，您需要在所有 Feed 中以及目录中的所有实体之间保持得分的比例一致。默认情况下，实体的热度得分设为 0。
popularityScore.@type 文本 一律设置为 PopularityScoreSpecification
popularityScore.value 编号 一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
popularityScore.eligibleRegion 国家/地区 相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 EARTH。默认情况下，此属性设置为 EARTH。
Note: 特定于语言区域的热度优先于全球（地球）热度

MusicAlbum

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
@type 文本 必需 - 对于专辑，始终设置为 MusicAlbum。
@id 网址 必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在您的目录中具有全局唯一性
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。
  • 以统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归您的组织所有。
由于实体的 url 符合作为标识符的所有要求，因此我们建议您使用实体的 url 作为 @id。如需了解详情，请参阅标识符部分。
url 网址 必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。
url 必须满足以下要求：
  • url 必须是全局唯一的
  • url 必须包含 Google 可以抓取的有效规范网址。
  • url 需要指向未被付费墙屏蔽的内容说明网页。
如需了解播放的深层链接，请参阅 target 对象的 urlTemplate 属性。
name 文本 必需 - 相册的名称。
byArtist MusicGroup 必需 - 录制相应专辑的音乐人或团体。您至少必须指定该音乐人使用的唯一 @id 以及音乐人的名称。如果专辑有多个关联的艺术家，您可以在 byArtist 中提供一个值数组。
byArtist.@type 文本 必需 - 对于此属性，请始终设置为 MusicGroup。
byArtist.@id 网址 必需 - 专辑音乐人的标识符。请参阅上文的 @id 要求。它必须与您在 Feed 中其他位置为相应音乐人/乐队使用的 @id 一致。
byArtist.name 文本 必需 - 艺术家/团体的名称。
potentialAction ListenAction 必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。
subjectOf MusicPlaylist 对于实体种子操作是必需的 - 实体种子操作的详细信息。
subjectOf.@type 文本 对于实体种子操作是必需的 - 此属性始终设置为 MusicPlaylist。
subjectOf.@id 网址 对于实体种子操作是必需的 - 实体种子操作的标识符。请参阅上文的 @id 要求。它必须与相册的 @id 不同。
subjectOf.url 网址 对于实体种子操作是必需的 - 实体种子操作的规范网址。请参阅上文的 url 要求。如果与影集的 url 相同，则可以省略此参数。
subjectOf.potentialAction ListenAction 实体种子 Action 必需 - 提供 Action 详细信息的 Action 标记对象。如需了解详情，请参阅操作标记属性。
image ImageObject 表示 MusicAlbum 的图片。请参阅图片标记属性。
sameAs 网址 可用于标识专辑的参考网页的网址；例如，专辑的维基百科网页。此值必须与 url 属性不同。
numTracks 整数 相应专辑中的歌曲或轨道数量。
timeRequired 文本 专辑的时长，采用 ISO 8601 格式。
description 文本 专辑的简要说明。300 个字符。
isFamilyFriendly 布尔值 表示相应内容是否适合全家观看（即内容是否适合家庭中的所有成员，包括儿童）。Google 产品可能会使用 isFamilyFriendly 来确定要播放的歌曲。
popularityScore PopularityScoreSpecification Google 使用的一种分数，用于与其他信号一起确定要为用户播放哪些媒体内容。此得分表示相应内容相对于您目录中其他内容的受欢迎程度；因此，您需要在所有 Feed 中以及目录中的所有实体之间保持得分的比例一致。默认情况下，实体的热度得分设为 0。
popularityScore.@type 文本 一律设置为 PopularityScoreSpecification
popularityScore.value 编号 一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
popularityScore.eligibleRegion 国家/地区 相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 EARTH。默认情况下，此属性设置为 EARTH。

MusicRecording

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
@type 文本 必需 - 对于歌曲/曲目，始终设置为 MusicRecording。
@id 网址 必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在您的目录中具有全局唯一性
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。
  • 以统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归您的组织所有。
由于实体的 url 符合作为标识符的所有要求，因此我们建议您使用实体的 url 作为 @id。如需了解详情，请参阅标识符部分。
url 网址 必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。
url 必须满足以下要求：
  • url 必须是全局唯一的
  • url 必须包含 Google 可以抓取的有效规范网址。
  • url 需要指向未被付费墙屏蔽的内容说明网页。
如需了解播放的深层链接，请参阅 target 对象的 urlTemplate 属性。
name 文本 必需 - 歌曲名称。
byArtist MusicGroup 必需 - 录制相应歌曲的音乐人或乐队。您至少必须指定该音乐人使用的唯一 @id 以及音乐人的名称。如果歌曲有多个关联的艺术家，您可以在 byArtist 中提供一个值数组。
byArtist.@type 文本 必需 - 对于此属性，请始终设置为 MusicGroup。
byArtist.@id 网址 必需 - 歌曲音乐人的标识符。请参阅上文的 @id 要求。它必须与您在 Feed 中其他位置为相应音乐人/乐队使用的 @id 一致。
byArtist.name 文本 必需 - 艺术家/团体的名称。
potentialAction ListenAction 必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。
subjectOf MusicPlaylist 对于实体种子操作是必需的 - 实体种子操作的详细信息
subjectOf.@type 文本 对于实体种子操作是必需的 - 此属性始终设置为 MusicPlaylist。
subjectOf.@id 网址 对于实体种子操作是必需的 - 实体种子操作的标识符。请参阅上文的 @id 要求。必须与歌曲的 @id 不同。
subjectOf.url 网址 对于实体种子操作是必需的 - 实体种子操作的规范网址。请参阅上文的 url 要求。如果与歌曲的 url 相同，则可以省略此参数。
subjectOf.potentialAction ListenAction 实体种子 Action 必需 - 提供 Action 详细信息的 Action 标记对象。如需了解详情，请参阅操作标记属性。
image ImageObject 表示 MusicRecording 的图片。请参阅图片标记属性。
sameAs 网址 可用于标识专辑的参考网页的网址；例如，专辑的维基百科网页。此值必须与 url 属性不同。
inAlbum MusicAlbum 曲目所在的专辑（如果有）。
inAlbum.@type 文本 此属性始终设置为 MusicAlbum。
inAlbum.@id 网址 相应专辑的标识符。请参阅上文的 @id 要求。它必须与您在 Feed 中其他位置为相应专辑使用的 @id 一致。
inAlbum.name 文本 相册的名称。
duration 文本 歌曲时长，采用 ISO 8601 格式。
description 文本 歌曲的简要说明。300 个字符。
isFamilyFriendly 布尔值 表示相应内容是否适合全家观看（即内容是否适合家庭中的所有成员，包括儿童）。Google 产品可能会使用 isFamilyFriendly 来确定要播放的歌曲。
popularityScore PopularityScoreSpecification Google 使用的一种分数，用于与其他信号一起确定要为用户播放哪些媒体内容。此得分表示相应内容相对于您目录中其他内容的受欢迎程度；因此，您需要在所有 Feed 中以及目录中的所有实体之间保持得分的比例一致。默认情况下，实体的热度得分设为 0。
popularityScore.@type 文本 一律设置为 PopularityScoreSpecification
popularityScore.value 编号 一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
popularityScore.eligibleRegion 国家/地区 相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 EARTH。默认情况下，此属性设置为 EARTH。

示例

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"
        }
      }
    }
  }
}

如需了解与这些媒体资源相关的主题，请参阅以下页面：