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

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

本節提供 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`。詳情請參閱「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:` 地區專屬熱門度會優先於全球 (地球) 熱門度

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`。詳情請參閱「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`。詳情請參閱「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"
        }
      }
    }
  }
}

藝人、專輯和歌曲的內容標記屬性 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

規格表

MusicGroup

MusicAlbum

MusicRecording

範例

MusicGroup

MusicAlbum

MusicRecording

相關網頁

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