音樂播放清單的內容標記屬性

本節提供 MusicPlaylist 實體類型的內容標記屬性詳細資料。

規格表

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.googleapis.com", {"@language": "xx"}]。
  • 其中「xx」代表動態饋給中字串的語言。每個根實體環境都應將 @language 的 @language 設定為適當的語言代碼 (BCP 47 格式)。舉例來說，如果語言是西班牙文，系統會假設名稱為西班牙文，即使字幕/英文語言為英文也一樣。
@type 文字 必要 - 混合模式一律設為 MusicPlaylist。
@id 網址 必要 - URI 格式的內容 ID，例如 https://example.com/1234abc。
@id必須符合下列規定：
  • 目錄中的全域唯一項目
  • 靜態；ID 應固定，不會隨著時間而改變 (即使節目網址的網址屬性有所變動)。系統會將其視為不透明字串，且不一定要是有效連結。
  • 統一資源識別碼 (URI) 的形式
  • @id 值使用的網域必須由貴機構所擁有。
由於實體的「url」符合所有 ID 規定，因此請使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - Google 會運用標準網址比對動態饋給中的內容與 Google 資料庫中的內容。
url 必須符合下列規定：
  • 「url」不得重複
  • url 必須包含 Google 可檢索的有效標準網址。
  • url 必須指向內容說明頁面，且該付費牆未遭到付費牆封鎖。
針對播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name 文字 必填 - 播放清單的名稱，例如「Funky Jazz Mix」。
genre 文字 如果播放清單是類型組合，此為必填屬性 - 針對播放清單代表的類型專屬的關鍵字清單。如果有這項資源，Google 就會知道您打算將此播放清單視為類型播放清單。
numTracks 整數 如果播放清單是收錄的合輯，則為必要項目 - 播放清單中的曲目數量。這項屬性的存在會通知 Google 這個播放清單是經過精心挑選。沒有這項屬性時，代表播放清單是系統自動產生的播放清單。
potentialAction ListenAction 必要 - 動作標記物件，可提供動作的詳細資料。詳情請參閱動作標記屬性。
image ImageObject 呈現播放清單或音樂組合的播放清單圖片。請參閱圖片標記屬性。
creator 機構組織或個人 如果創作者對內容有興趣，則建議使用這個選項。請使用這項屬性來指定服務建立的播放清單 (類型必須為「機構」，並以 name 屬性表示服務)，或服務高度感興趣的使用者 (輸入「使用者」，並以 name 屬性表示感興趣的使用者)。
keywords 文字 關鍵字清單 (「搖滾」、「流行」) 和情境 (「開心」、「活力」、「活動」(「放鬆」) 或其他與播放清單相關的字詞。
description 文字 播放清單的簡短說明，長度上限為 300 個半形字元。
isFamilyFriendly 布林 表示這項內容是否闔家適用 (也就是說，內容適合所有家庭成員，包括兒童)。Google 產品可能會使用 isFamilyFriendly 來判斷要播放的歌曲。
popularityScore 熱門分數規格 強烈建議使用原因Google 會使用分數和其他信號來判斷要播放哪些媒體內容。這個分數代表內容相對於目錄中其他內容的熱門程度，因此在目錄中的所有實體中，分數與#39; 比例必須保持一致。實體的預設分數預設為 0。
popularityScore.@type 文字 一律設為 PopularityScoreSpecification。
popularityScore.value Number 代表實體熱門程度的非負數值；分數越高表示熱門程度越高。
popularityScore.eligibleRegion 國家/地區 適用這個熱門分數的地區。如果全球的熱門分數全面適用，請設為 EARTH。根據預設，此屬性已設為 EARTH。
Note: 地區熱門程度的優先順序高於全球 (EARTH) 熱門程度

範例

以下是 2010 年代流行歌曲的手動收錄播放清單範例：

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/playlist/top-pop-songs/",
  "url":"http://www.example.com/playlist/top-pop-songs/",
  "name":"Top Pop Songs of the 2010s",
  "image":[
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["US","UK","MX"]
  },
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["UA", "IR"]
  }],
  "genre": [
     "pop",
     "2010s"
  ],
  "numTracks":"46",
  "potentialAction":{
    "@type":"ListenAction",
    "target":[
      {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/playlist/top-pop-songs?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"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"free",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "creator": {
    "@type": "Organization",
    "name": "example.com"
  },
  "keywords": [
    "pop",
    "Party music"
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"Top pop songs from the last decade."
}

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