音乐人、专辑和歌曲的内容标记属性

本部分详细介绍了 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"
        }
      }
    }
  }
}

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