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

本部分详细介绍了 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 标记对象。有关详情，请参阅操作标记属性。
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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度

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 网址 实体种子 Action 为必需项 - 实体种子操作的标识符。请参阅上述 @id 的要求。它必须不同于影集的 @id。
subjectOf.url 网址 对于实体种子操作而言是必需的 - 实体种子操作的规范网址。请参阅上述 url 的要求。如果它与影集的 url 相同，则可以省略它。
subjectOf.potentialAction ListenAction 实体种子 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 标记对象。有关详情，请参阅操作标记属性。
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"
        }
      }
    }
  }
}

您可以访问以下页面，了解与这些属性相关的主题：