音乐播放列表的内容标记属性

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

规格表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式格式的相应语言代码。例如，如果语言设置为西班牙语，那么即使字幕语言为英语，系统也会假定名称也采用西班牙语。
@type 文本 必需 - 混音效果始终设置为 MusicPlaylist。
@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 文本 必需 - 播放列表的名称，例如“放克爵士乐合辑”。
genre 文本 如果播放列表是流派合辑，则必须提供 - 播放列表所代表的类型的特定关键字列表。如果存在此属性，则 Google 会认为你希望将此播放列表设为流派播放列表。
numTracks 整数 如果播放列表是精选合辑，则为必需 - 播放列表中曲目的数量。此属性的显示会向 Google 表明，此播放列表是经过人工挑选的。缺少此属性表示该播放列表是一个无限自动生成的播放列表。
potentialAction ListenAction 必需 - 一个操作标记对象，用于提供操作的详细信息。有关详情，请参阅操作标记属性。
image ImageObject 代表播放列表或音乐合辑的播放列表图片。请参阅图片标记属性。
creator Organization 或 Person 如果创作者非常感兴趣，则推荐选择此选项。使用此属性可以指明由您的服务创建的播放列表（类型为组织，其 name 属性表示您的服务）或对您的服务感兴趣的高兴趣用户（类型为 Person，其 name 属性表示感兴趣的用户）。
keywords 文本 关键字列表（“摇滚”、“流行”）、心情（“快乐”“忧郁”）、活动（“锻炼”“放松”）或与播放列表相关的其他字词。
description 文本 播放列表的简要说明。最多 300 个字符。
isFamilyFriendly 布尔值 指明此内容是否全家皆宜（即，内容适合所有家庭成员，包括儿童）。Google 产品在确定要播放的歌曲时可能会使用 isFamilyFriendly。
popularityScore PopularityScoreSpecification 强烈推荐为什么？Google 会根据此得分以及其他信号来确定要为用户播放哪些媒体。此得分表示该内容相对于目录中其他内容的热门程度；因此，您的 Feed 以及目录中的所有实体中的得分范围需要保持一致。默认情况下，实体的热门程度得分设置为 0。
popularityScore.@type 文本 始终设置为 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."
}

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