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

本節提供 MusicGroup、MusicAlbum 和 MusicRecording 實體類型的內容標記屬性詳細資料。

規格表

MusicGroup

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

MusicAlbum

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

MusicRecording

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

請參閱下列網頁，瞭解與這些房源相關的主題：