พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของเพลย์ลิสต์เพลง

ส่วนนี้จะแสดงรายละเอียดพร็อพเพอร์ตี้ของมาร์กอัปเนื้อหาสําหรับประเภทเอนทิตี MusicPlaylist

ตารางข้อมูลจําเพาะ

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text จําเป็น - ตั้งค่าเป็น ["http://schema.googleapis.com", {"@language": "xx"}] เสมอ
  • โดยที่ "xx" จะแสดงภาษาของสตริงในฟีด บริบทเอนทิตีเอนทิตีแต่ละรายการควรตั้งค่า @language เป็นโค้ดภาษาที่เหมาะสมในรูปแบบ BCP 47 ตัวอย่างเช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาของคําบรรยาย/เสียงพากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น MusicPlaylist สําหรับมิกซ์เสมอ
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกําหนดต่อไปนี้
  • ไม่ซ้ํากันทั่วทั้งแคตตาล็อก
  • คงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ URL ของรายการจะเปลี่ยนแปลงก็ตาม) โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จําเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สําหรับค่า @id ต้องเป็นขององค์กรของคุณ
เนื่องจาก url ของเอนทิตีตรงกับข้อกําหนดทั้งหมดเป็นตัวระบุ เราจึงขอแนะนําให้ใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้จับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google'
url ต้องเป็นไปตามข้อกําหนดต่อไปนี้
  • url ต้องไม่ซ้ํากันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
  • url ต้องชี้ไปที่หน้ารายละเอียดเนื้อหาที่ไม่ถูกบล็อกโดยเพย์วอลล์
สําหรับความลึกของการเล่น ให้ดูที่พร็อพเพอร์ตี้ target และออบเจ็กต์ urlTemplate แทน
name Text ต้องระบุ - ชื่อของเพลย์ลิสต์ เช่น "Funky Jazz Mix"
genre Text ต้องระบุหากเพลย์ลิสต์เป็นมิกซ์ประเภท - รายการคีย์เวิร์ดที่ระบุเฉพาะเจาะจงสําหรับแนวเพลงที่เพลย์ลิสต์แสดง การมีพร็อพเพอร์ตี้นี้เป็นสัญญาณให้ Google ทราบว่าคุณตั้งใจที่จะทําให้เพลย์ลิสต์นี้เป็นเพลย์ลิสต์ประเภท
numTracks จำนวนเต็ม ต้องระบุหากเพลย์ลิสต์เป็นมิกซ์ที่ดูแลจัดการ - จํานวนแทร็กในเพลย์ลิสต์ การมีพร็อพเพอร์ตี้นี้เป็นสัญญาณให้ Google ทราบว่าเพลย์ลิสต์นี้มีการดูแลจัดการ การไม่มีพร็อพเพอร์ตี้นี้จะบ่งบอกว่าเพลย์ลิสต์เป็นเพลย์ลิสต์ที่สร้างขึ้นโดยอัตโนมัติไม่มีที่สิ้นสุด
potentialAction การดำเนินการเพื่อฟัง จําเป็น - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ ดูรายละเอียดได้ที่พร็อพเพอร์ตี้มาร์กอัปการดําเนินการ
image ImageObject รูปภาพเพลย์ลิสต์ซึ่งแสดงเพลย์ลิสต์หรือมิกซ์เพลง ดูคุณสมบัติของมาร์กอัปรูปภาพ
creator องค์กรหรือบุคคล แนะนําหากครีเอเตอร์มีความสนใจสูง ใช้พร็อพเพอร์ตี้นี้เพื่อระบุเพลย์ลิสต์ที่สร้างโดยบริการของคุณ (พิมพ์เป็นองค์กรโดยมีพร็อพเพอร์ตี้ name ซึ่งระบุบริการของคุณ) หรือผู้ใช้บริการที่สนใจ (พิมพ์เป็นบุคคลโดยมีพร็อพเพอร์ตี้ name ซึ่งระบุผู้ใช้ที่สนใจ)
keywords Text รายการคีย์เวิร์ด ("rock", "pop") อารมณ์ ("happy", "moody") กิจกรรม ("การออกกําลังกาย" "การผ่อนคลาย") หรือคําอื่นๆ ที่เกี่ยวข้องกับเพลย์ลิสต์
description Text คําอธิบายสั้นๆ ของเพลย์ลิสต์ จํานวนอักขระสูงสุด 300 ตัว
isFamilyFriendly บูลีน ระบุว่าเนื้อหานี้เหมาะสําหรับครอบครัวหรือไม่ (กล่าวคือ เนื้อหาเหมาะสําหรับสมาชิกทุกคนในครอบครัว รวมถึงเด็ก) ผลิตภัณฑ์ของ Google อาจใช้ isFamilyFriendly เมื่อกําหนดเพลงที่จะเล่น
popularityScore ข้อมูลจําเพาะของความนิยม แนะนําอย่างยิ่งสาเหตุ คะแนนที่ Google ใช้ รวมถึงสัญญาณอื่นๆ เพื่อกําหนดว่าจะเล่นสื่อใดสําหรับผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อกของคุณ ดังนั้นคะแนนของฟีดข้อมูลต้องสอดคล้องกันในทุกระดับของแคตตาล็อก คะแนนความนิยมของเอนทิตีจะเป็น 0 โดยค่าเริ่มต้น
popularityScore.@type Text ตั้งค่าเป็น 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."
}

ดูหน้าต่อไปนี้สําหรับหัวข้อที่เกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้