Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

本部分详细介绍了 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` 需要指向未被付费墙屏蔽的内容说明网页。如需了解播放的深层链接，请参阅 target 对象的 `urlTemplate` 属性。
`name`	文本	必需 - 音乐人或乐队的名称。使用数组列出不同语言的名称。请参阅多个区域和语言示例。
`potentialAction`	ListenAction	必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。使用数组可在多个区域中指定不同的深层链接。请参阅多个区域和语言示例。
`subjectOf`	MusicPlaylist	对于实体种子操作是必需的 - 实体种子操作的详细信息。
`subjectOf.@type`	文本	对于实体种子操作是必需的 - 此属性始终设置为 `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` 需要指向未被付费墙屏蔽的内容说明网页。如需了解播放的深层链接，请参阅 target 对象的 `urlTemplate` 属性。
`name`	文本	必需 - 相册的名称。使用数组列出不同语言的名称。请参阅多个区域和语言示例。
`byArtist`	MusicGroup	必需 - 录制相应专辑的音乐人或团体。您至少必须指定该音乐人使用的唯一 `@id` 以及音乐人的名称。如果专辑有多个关联的艺术家，您可以在 byArtist 中提供一个值数组。
`byArtist.@type`	文本	必需 - 对于此属性，请始终设置为 `MusicGroup`。
`byArtist.@id`	网址	必需 - 专辑音乐人的标识符。请参阅上文的 `@id` 要求。它必须与您在 Feed 中其他位置为相应音乐人/乐队使用的 `@id` 一致。
`byArtist.name`	文本	必需 - 艺术家/团体的名称。
`potentialAction`	ListenAction	必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。使用数组可在多个区域中指定不同的深层链接。请参阅多个区域和语言示例。
`subjectOf`	MusicPlaylist	对于实体种子操作是必需的 - 实体种子操作的详细信息。
`subjectOf.@type`	文本	对于实体种子操作是必需的 - 此属性始终设置为 `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` 需要指向未被付费墙屏蔽的内容说明网页。如需了解播放的深层链接，请参阅 target 对象的 `urlTemplate` 属性。
`name`	文本	必需 - 歌曲名称。使用数组列出不同语言的名称。请参阅多个地区和语言示例。
`byArtist`	MusicGroup	必需 - 录制相应歌曲的音乐人或乐队。您至少必须指定该音乐人使用的唯一 `@id` 以及音乐人的名称。如果歌曲有多个关联的艺术家，您可以在 byArtist 中提供一个值数组。
`byArtist.@type`	文本	必需 - 对于此属性，请始终设置为 `MusicGroup`。
`byArtist.@id`	网址	必需 - 歌曲音乐人的标识符。请参阅上文的 `@id` 要求。它必须与您在 Feed 中其他位置为相应音乐人/乐队使用的 `@id` 一致。
`byArtist.name`	文本	必需 - 艺术家/团体的名称。
`potentialAction`	ListenAction	必需 - 提供操作详细信息的操作标记对象。如需了解详情，请参阅操作标记属性。使用数组可在多个区域中指定不同的深层链接。请参阅多个区域和语言示例。
`subjectOf`	MusicPlaylist	对于实体种子操作是必需的 - 实体种子操作的详细信息
`subjectOf.@type`	文本	对于实体种子操作是必需的 - 此属性始终设置为 `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"
        }
      }
    }
  }
}

音乐人、专辑和歌曲的内容标记属性 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

规范表

MusicGroup

MusicAlbum

MusicRecording

示例

MusicGroup

MusicAlbum

MusicRecording

相关页面

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