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

本節將詳細說明 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"
        }
      }
    }
  }
}

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