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

本部分详细介绍了 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 需要指向未被付费墙屏蔽的内容说明页。
如需获取播放的深层链接，请改为查看目标对象的 urlTemplate 属性。
name 文本 必需 - 播放列表的名称，例如“Funky Jazz Mix”。
genre 文本 如果播放列表是类型混合，则必填 - 与播放列表所代表的类型相关的关键字列表。此属性的存在会向 Google 表明您打算将此播放列表设为类型播放列表。
numTracks 整数 如果播放列表是精选混音，则必需提供 - 播放列表中的曲目数量。此属性的存在会向 Google 表明此播放列表是手动精选的。如果缺少此属性，则表示播放列表是自动生成的无限播放列表。
potentialAction ListenAction 必需 - 一个操作标记对象，用于提供操作的详细信息。如需了解详情，请参阅Action 标记属性。
image ImageObject 代表播放列表或音乐合辑的播放列表图片。请参阅图片标记属性。
creator 组织或个人 如果创作者非常受欢迎，建议采用此选项。使用此属性可指明您的服务创建的播放列表（类型为 Organization，其 name 属性指示您的服务）或对您的服务感兴趣的用户（类型为 Person，其 name 属性指示感兴趣的用户）。
keywords 文本 关键字（“摇滚”“流行”）、情绪（“快乐”“情绪低落”）、活动（“锻炼”“放松”）或与歌单相关的其他字词的列表。
description 文本 播放列表的简要说明。字符数限制为 300 个字符。
isFamilyFriendly 布尔值 指示此内容是否适合全家观看（即内容适合家庭中的所有成员，包括儿童）。Google 产品在确定要播放的歌曲时可能会使用 isFamilyFriendly。
popularityScore PopularityScoreSpecification 强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
popularityScore.@type 文本 始终设置为 PopularityScoreSpecification。
popularityScore.value 编号 一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
popularityScore.eligibleRegion 国家/地区 此人气指数适用的地区。如果热门程度得分适用于全球，请设为 EARTH。默认情况下，此属性设置为 EARTH。
Note: 特定语言区域的热门程度优先于全球（地球）热门程度

示例

包含 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."
}

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