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

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

規格表

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.googleapis.com", {"@language": "xx"}]
  • 「xx」的位置會呈現動態饋給中字串的語言。每個根實體內容都應將 @language 設為適當的語言代碼,並採用 BCP 47 格式。舉例來說,如果將語言設為西班牙文,即使字幕/配音語言是英文,系統也會假設名稱是以西班牙文顯示。
@type 文字 必要 - 如果是 Mix,一律設為 MusicPlaylist
@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 文字 必要 - 播放清單的名稱,例如「Funky Jazz Mix」。
genre 文字 如果播放清單為類型組合,則為必填:播放清單代表的音樂類型清單。如果有這項資源,Google 就會知道你希望這個播放清單是類型播放清單。
numTracks 整數 如果播放清單為精選合輯,則為必填:播放清單中的曲目數量。如果有這項資源,Google 就會知道這個播放清單是精選內容。如果您缺少這個屬性,就表示這個播放清單是系統自動產生的播放清單。
potentialAction ListenAction 必要 - 提供動作詳細資料的 動作標記物件。詳情請參閱動作標記屬性
image ImageObject 代表播放清單或音樂合輯的播放清單圖片。請參閱「圖片標記屬性」一文。
creator 機構Person 如果創作者感興趣,則建議使用這個選項。這個屬性可用來指出您的服務所建立的播放清單 (標示為 Organization,其 name 屬性表示您的服務),或對您的服務有高度興趣的使用者 (類型為 Person,其 name 屬性代表感興趣的使用者)。
keywords 文字 關鍵字清單 (「搖滾樂」、「流行樂」)、情境 (「快樂」、「心情」)、活動 (「運動」、「放鬆」) 或其他與播放清單相關的字詞。
description 文字 播放清單的簡短說明。長度上限為 300 個半形字元。
isFamilyFriendly 布林值 指出內容是否闔家適用,也就是該內容適合所有家庭成員,包括兒童。Google 產品可能會使用 isFamilyFriendly 決定要播放的歌曲。
popularityScore PopularityScoreSpecification 強烈建議原因Google 運用分數和其他信號來判斷要向使用者顯示的媒體。這個分數代表相較於你的目錄中其他內容,該內容的熱門程度。因此,動態饋給中所有實體的分數都必須一致。根據預設,實體的熱門程度分數會設為 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."
}

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