音乐人、专辑和歌曲的内容标记属性
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本部分详细介绍了 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 需要指向未被付费墙屏蔽的内容说明页。
如需获取播放的深层链接，请改为查看目标对象的 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"
}
}
}
}
}
相关页面
如需了解与这些媒体资源相关的主题，请参阅以下页面：
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],[],[],["The core content defines the schema for music entities: `MusicGroup`, `MusicAlbum`, and `MusicRecording`. Key actions include: specifying `@id`, `url`, and `name` for each entity; linking `MusicAlbum` to `MusicGroup` via `byArtist`; detailing `potentialAction` for listening; and defining `subjectOf` for entity-seeded actions. Each requires a unique, crawlable URL, and optional details like `description`, `image`, and `sameAs` enhance the data. Popularity is tracked via `popularityScore`. Specific actions and entities are required to populate different fields.\n"]]
