藝人、專輯和歌曲的內容標記屬性

本節將詳細說明 MusicGroup、MusicAlbum 和 MusicRecording 實體類型的內容標記屬性。

規格表

MusicGroup

屬性	預期類型	說明
@context	Text	必填 - 一律設為 ["http://schema.googleapis.com", {"@language": "xx"}]。 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
@type	Text	必要：一律將藝人和團體設為 MusicGroup。
@id	網址	必填：內容的 ID，格式為 URI，例如 https://example.com/1234abc。 @id 必須符合下列規定： 在目錄中全域專屬 靜態；這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 統一資源識別碼 (URI) 格式 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合 ID 的所有必要條件，建議您將實體的 url 做為 @id。詳情請參閱「識別碼」一節。
url	網址	必填：內容的標準網址，Google 會使用這項資訊，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 url 必須指向未受付費牆阻擋的內容說明頁面。 如要取得播放內容的深層連結，請改為參閱 target 物件的 urlTemplate 屬性。
name	Text	必填：藝人或團體的名稱。 使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。
potentialAction	ListenAction	必要：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
subjectOf	MusicPlaylist	適用於實體播種動作的必要屬性：實體播種動作的詳細資料。
subjectOf.@type	Text	實體種子動作的必要屬性：請一律將這個屬性設為 MusicPlaylist。
subjectOf.@id	網址	實體種子動作的必填屬性：實體種子動作的 ID。請參閱上方的 @id 相關規定。必須與藝人/團體的 @id 不同。
subjectOf.url	網址	實體播種動作的必要屬性：實體播種動作的標準網址。請參閱上方的 url 相關規定。如果與藝人/團體的 url 相同，可以省略這項資訊。
subjectOf.potentialAction	ListenAction	針對實體播放的動作為必填：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
image	ImageObject	代表 MusicGroup 的圖片。請參閱「圖片標記屬性」。
sameAs	網址	可識別藝人的參考網頁網址，例如藝人的維基百科網頁。這必須與 url 屬性不同。
description	Text	藝人的簡短傳記。長度上限為 300 個半形字元 。 使用陣列標記多種語言的說明。請參閱「多個地區和語言」範例。
isFamilyFriendly	布林值	表示內容是否闔家觀賞 (即內容適合所有家庭成員，包括兒童)。Google 產品在決定要播放哪首歌曲時，可能會使用 isFamilyFriendly。
popularityScore	PopularityScoreSpecification	強烈建議Google 會使用這個分數，搭配其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
popularityScore.@type	Text	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
popularityScore.eligibleRegion	國家/地區	這個熱門程度分數適用的區域。如果人氣分數適用於全球，請將其設為 EARTH。根據預設，此屬性會設為 EARTH。 Note: 當地熱門程度優先於全球 (EARTH) 熱門程度

MusicAlbum

屬性	預期類型	說明
@context	Text	必填 - 一律設為 ["http://schema.googleapis.com", {"@language": "xx"}]。 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
@type	Text	必填：一律設為相簿的 MusicAlbum。
@id	網址	必填：內容的 ID，格式為 URI，例如 https://example.com/1234abc。 @id 必須符合下列規定： 在目錄中全域專屬 靜態；這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 統一資源識別碼 (URI) 格式 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合 ID 的所有必要條件，建議您將實體的 url 做為 @id。詳情請參閱「識別碼」一節。
url	網址	必填：內容的標準網址，Google 會使用這項資訊，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 url 必須指向未受付費牆阻擋的內容說明頁面。 如要取得播放內容的深層連結，請改為參閱 target 物件的 urlTemplate 屬性。
name	Text	必填：相簿名稱。 使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。
byArtist	MusicGroup	必要：錄製這張專輯的藝人或團體。您至少必須指定為該藝人使用的專屬 @id 和藝人名稱。如果專輯有多位關聯藝人，您可以在 byArtist 中提供值陣列。
byArtist.@type	Text	必填：請一律將這項屬性設為 MusicGroup。
byArtist.@id	網址	必填：專輯藝人的 ID。請參閱上方的 @id 相關規定。必須與動態饋給中其他位置的藝人/團體所使用的 @id 相符。
byArtist.name	Text	必填：藝人/團體名稱。
potentialAction	ListenAction	必要：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
subjectOf	MusicPlaylist	適用於實體播種動作的必要屬性：實體播種動作的詳細資料。
subjectOf.@type	Text	實體種子動作的必要屬性：請一律將這個屬性設為 MusicPlaylist。
subjectOf.@id	網址	實體種子動作的必填屬性：實體種子動作的 ID。請參閱上方的 @id 相關規定。必須與相簿的 @id 不同。
subjectOf.url	網址	實體種子動作的必要屬性：實體種子動作的標準網址。請參閱上方的 url 相關規定。如果與相簿的 url 相同，可以省略這項資訊。
subjectOf.potentialAction	ListenAction	針對實體播放的動作為必填：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
image	ImageObject	代表 MusicAlbum 的圖片。請參閱「圖片標記屬性」。
sameAs	網址	可識別專輯的參考網頁網址，例如專輯的維基百科網頁。這必須與 url 屬性不同。
numTracks	整數	專輯中的歌曲或曲目數量。
timeRequired	Text	專輯的長度，採 ISO 8601 格式。
description	Text	專輯的簡短說明。長度上限為 300 個半形字元 。 使用陣列標記多種語言的說明。請參閱「多個地區和語言」範例。
isFamilyFriendly	布林值	表示內容是否闔家觀賞 (即內容適合所有家庭成員，包括兒童)。Google 產品在決定要播放哪首歌曲時，可能會使用 isFamilyFriendly。
popularityScore	PopularityScoreSpecification	Google 會使用這個分數，搭配其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
popularityScore.@type	Text	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
popularityScore.eligibleRegion	國家/地區	這個熱門程度分數適用的區域。如果人氣分數適用於全球，請將其設為 EARTH。根據預設，這個屬性會設為 EARTH。

MusicRecording

屬性	預期類型	說明
@context	Text	必填 - 一律設為 ["http://schema.googleapis.com", {"@language": "xx"}]。 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
@type	Text	必填：一律設為 MusicRecording (適用於歌曲/曲目)。
@id	網址	必填：內容的 ID，格式為 URI，例如 https://example.com/1234abc。 @id 必須符合下列規定： 在目錄中全域專屬 靜態；這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 統一資源識別碼 (URI) 格式 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合 ID 的所有必要條件，建議您將實體的 url 做為 @id。詳情請參閱「識別碼」一節。
url	網址	必填：內容的標準網址，Google 會使用這項資訊，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 url 必須指向未受付費牆阻擋的內容說明頁面。 如要取得播放內容的深層連結，請改為參閱 target 物件的 urlTemplate 屬性。
name	Text	必填：歌曲名稱。 使用陣列列出不同語言的名稱。請參閱多個地區和語言範例。
byArtist	MusicGroup	必填：錄製這首歌的藝人或樂團。您至少必須指定為該藝人使用的專屬 @id 和藝人名稱。如果歌曲有多位關聯藝人，您可以在 byArtist 中提供值陣列。
byArtist.@type	Text	必填：請一律將這項屬性設為 MusicGroup。
byArtist.@id	網址	必填：歌曲藝人的 ID。請參閱上方的 @id 相關規定。必須與動態饋給中其他位置的藝人/團體所使用的 @id 相符。
byArtist.name	Text	必填：藝人/團體名稱。
potentialAction	ListenAction	必要：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
subjectOf	MusicPlaylist	實體播種動作的必要屬性 - 實體播種動作的詳細資料
subjectOf.@type	Text	實體種子動作的必要屬性：請一律將這個屬性設為 MusicPlaylist。
subjectOf.@id	網址	實體種子動作專用 (必填)：實體種子動作的 ID。請參閱上方的 @id 相關規定。必須與歌曲的 @id 不同。
subjectOf.url	網址	實體播種動作的必要屬性：實體播種動作的標準網址。請參閱上方的 url 相關規定。如果與歌曲的 url 相同，可以省略這項資訊。
subjectOf.potentialAction	ListenAction	針對實體播放的動作為必填：提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。 使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
image	ImageObject	代表 MusicRecording 的圖片。請參閱「圖片標記屬性」。
sameAs	網址	可識別專輯的參考網頁網址，例如專輯的維基百科網頁。這必須與 url 屬性不同。
inAlbum	MusicAlbum	該曲目所屬的專輯 (如果有的話)。
inAlbum.@type	Text	請一律將這個屬性設為 MusicAlbum。
inAlbum.@id	網址	專輯的 ID。請參閱上方的 @id 相關規定。必須與動態饋給中其他位置的相簿使用的 @id 相符。
inAlbum.name	Text	相簿的名稱。
duration	Text	歌曲的長度，採 ISO 8601 格式。
description	Text	歌曲的簡短說明。長度上限為 300 個半形字元 。 使用陣列標記多種語言的說明。請參閱「多個地區和語言」範例。
isFamilyFriendly	布林值	表示內容是否闔家觀賞 (即內容適合所有家庭成員，包括兒童)。Google 產品在決定要播放哪首歌曲時，可能會使用 isFamilyFriendly。
popularityScore	PopularityScoreSpecification	Google 會使用這個分數，搭配其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
popularityScore.@type	Text	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
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"
        }
      }
    }
  }
}

相關網頁

如要瞭解與這些屬性相關的主題，請參閱下列頁面：

• 找出內容的實體類型
• 收集內容的 ID、網址和名稱
• 找出 MusicGroup、MusicAlbum、MusicRecording 和 MusicPlaylist 之間的關係
• 收集內容的中繼資料