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

本部分详细介绍了 MusicGroupMusicAlbumMusicRecording 实体类型的内容标记属性。

规范表

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 需要指向未被付费墙屏蔽的内容说明页。
如需获取播放的深层链接,请改为查看目标对象的 urlTemplate 属性。
name 文本 必填 - 音乐人或乐队的名称。
potentialAction ListenAction 必需 - 一个操作标记对象,用于提供操作的详细信息。如需了解详情,请参阅Action 标记属性
subjectOf MusicPlaylist 对于实体启动的操作是必需的 - 实体启动的操作的详细信息。
subjectOf.@type 文本 对于实体启动的 Action 是必需的 - 此属性始终设置为 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 需要指向未被付费墙屏蔽的内容说明页。
如需获取播放的深层链接,请改为查看目标对象的 urlTemplate 属性。
name 文本 必填 - 影集的名称。
byArtist MusicGroup 必填 - 录制此专辑的音乐人或乐队。您至少必须指定为该音乐人使用的唯一 @id 和音乐人的姓名。如果专辑有多个关联的音乐人,您可以在 byArtist 中提供一个值数组。
byArtist.@type 文本 必需 - 此属性始终设置为 MusicGroup
byArtist.@id 网址 必需 - 专辑音乐人的标识符。请参阅上文对 @id 的要求。它必须与您在 Feed 的其他位置为相应音乐人/乐队使用的 @id 一致。
byArtist.name 文本 必填 - 音乐人/乐队的名称。
potentialAction ListenAction 必需 - 一个操作标记对象,用于提供操作的详细信息。如需了解详情,请参阅Action 标记属性
subjectOf MusicPlaylist 对于实体启动的操作是必需的 - 实体启动的操作的详细信息。
subjectOf.@type 文本 对于实体启动的 Action 是必需的 - 此属性始终设置为 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 需要指向未被付费墙屏蔽的内容说明页。
如需获取播放的深层链接,请改为查看目标对象的 urlTemplate 属性。
name 文本 必填 - 歌曲名称。
byArtist MusicGroup 必填 - 录制此歌曲的音乐人或乐队。您至少必须指定为该音乐人使用的唯一 @id 和音乐人的姓名。如果歌曲有多个关联的音乐人,您可以在 byArtist 中提供一个值数组。
byArtist.@type 文本 必需 - 此属性始终设置为 MusicGroup
byArtist.@id 网址 必需 - 歌曲音乐人的标识符。请参阅上文对 @id 的要求。它必须与您在 Feed 的其他位置为相应音乐人/乐队使用的 @id 一致。
byArtist.name 文本 必填 - 音乐人/乐队的名称。
potentialAction ListenAction 必需 - 一个操作标记对象,用于提供操作的详细信息。如需了解详情,请参阅Action 标记属性
subjectOf MusicPlaylist 对于实体启发型 Action 是必需的 - 实体启发型 Action 的详细信息
subjectOf.@type 文本 对于实体启动的 Action 是必需的 - 此属性始终设置为 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"
        }
      }
    }
  }
}

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