本部分详细介绍了 MusicPlaylist
实体类型的内容标记属性。
规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}] 。
|
@type |
Text | 必需 - 对于合辑,一律设置为 MusicPlaylist 。 |
@id |
网址 | 必需 - 内容的标识符(采用 URI 格式),例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足作为标识符的所有要求,因此我们建议您将该实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
网址 | 必需 - 内容的规范网址,Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求:
urlTemplate 属性。 |
name |
Text | 必需 - 播放列表的名称,例如“时尚爵士乐合辑”。
|
genre |
Text | 播放列表类型混用 - 播放列表所代表的类型的关键字列表。该资源的存在表明 Google 您希望此播放列表是类型播放列表。 |
numTracks |
整数 | 如果播放列表是精选合辑的必需标签 - 播放列表中的曲目数量。此属性的存在会告知 Google 此播放列表是手动精选的。如果缺少此属性,则表示播放列表是自动生成的无限播放列表。 |
potentialAction |
ListenAction | 必需 - 操作标记对象,提供操作的详细信息。如需了解详情,请参阅操作标记属性。 |
image |
ImageObject | 代表播放列表或音乐合辑的播放列表图片。请参阅图片标记属性。 |
creator |
组织或个人 | 创作者很感兴趣。使用此属性可指明由您的服务创建的播放列表(类型:组织,其 name 属性可指明您的服务);或您的服务感兴趣的用户(类型:用户,其 name 属性:指明相关用户)。 |
keywords |
Text | 一系列与播放列表相关的关键字("摇滚"、"流行"、心情("快乐"、"忧郁"、"活动"、"放松")或其他字词的列表。 |
description |
Text | 播放列表的简短说明。字符数限制为 300 个。
|
isFamilyFriendly |
Boolean | 指明此内容是否适合全家观看(即此类内容是否适合所有家庭成员,包括儿童)。Google 产品可能会使用 isFamilyFriendly 来确定要播放的歌曲。 |
popularityScore |
热门程度得分规范 | 强烈建议原因Google 根据得分和其他信号来确定要为用户播放的媒体。此分数代表着内容相对于您目录中的其他内容的受欢迎程度,因此该分数在 Feed 中必须与您目录中的所有实体保持一致。默认情况下,实体的受欢迎程度得分设置为 0。 |
popularityScore.@type |
Text | 始终设置为 PopularityScoreSpecification 。 |
popularityScore.value |
编号 | 表示实体热门程度的非负数值;分数越高,则表示热门程度越高。 |
popularityScore.eligibleRegion |
国家/地区 | 此热门程度得分适用的地区。如果热门程度得分适用于全球,则设置为 EARTH 。默认情况下,此属性会设置为 EARTH 。Note: 基于语言区域的热门程度高于全球 (EARTH) 热门程度 |
示例
包含手动精选的 2010 年代流行歌曲播放列表的示例:
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicPlaylist",
"@id":"http://www.example.com/playlist/top-pop-songs/",
"url":"http://www.example.com/playlist/top-pop-songs/",
"name":"Top Pop Songs of the 2010s",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}],
"genre": [
"pop",
"2010s"
],
"numTracks":"46",
"potentialAction":{
"@type":"ListenAction",
"target":[
{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/playlist/top-pop-songs?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"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
"actionPlatform": "http://schema.org/AndroidPlatform"
}
],
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"creator": {
"@type": "Organization",
"name": "example.com"
},
"keywords": [
"pop",
"Party music"
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description":"Top pop songs from the last decade."
}
相关页面
请查看以下页面,了解与这些属性相关的主题: