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

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

规范表

属性 预期类型 说明
@context Text 必需 - 始终设置为 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文的 @language 均应设置为采用 BCP 47 格式格式的相应语言代码。例如，如果语言设置为西班牙语，则即使字幕/配音语言为英语，系统也会假定名称为西班牙语。
@type Text 必需 - 对于合辑，一律设置为 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 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."
}

请查看以下页面，了解与这些属性相关的主题：