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

ส่วนนี้จะแสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี 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 ของรายการจะเปลี่ยนแปลงก็ตาม) ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google จะใช้จับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google ทำการ Crawl ได้
  • url ต้องชี้ไปยังหน้าคำอธิบายเนื้อหาที่ไม่ได้ถูกบล็อกโดยเพย์วอลล์
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
name Text ต้องระบุ - ชื่อเพลย์ลิสต์ เช่น "Funky Jazz Mix"
genre Text ต้องระบุหากเพลย์ลิสต์เป็นประเภทผสม - รายการคีย์เวิร์ดที่เจาะจงสำหรับประเภทที่เพลย์ลิสต์นำเสนอ การมีพร็อพเพอร์ตี้นี้บ่งบอกให้ Google ทราบว่าคุณตั้งใจให้เพลย์ลิสต์นี้เป็นเพลย์ลิสต์ประเภทเพลง
numTracks จำนวนเต็ม ต้องระบุหากเพลย์ลิสต์เป็นมิกซ์ที่มีการดูแลจัดการ - จำนวนแทร็กในเพลย์ลิสต์ การมีอยู่ของพร็อพเพอร์ตี้นี้บ่งบอกให้ Google ทราบว่าเพลย์ลิสต์นี้ได้รับการดูแลจัดการโดยเจ้าหน้าที่ หากไม่มีพร็อพเพอร์ตี้นี้ แสดงว่าเพลย์ลิสต์เป็นเพลย์ลิสต์ที่สร้างโดยอัตโนมัติแบบไม่สิ้นสุด
potentialAction การดำเนินการเพื่อฟัง ต้องระบุ - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ ดูรายละเอียดได้ที่พร็อพเพอร์ตี้มาร์กอัปการดําเนินการ
image ImageObject รูปภาพเพลย์ลิสต์ที่แสดงถึงเพลย์ลิสต์หรือมิกซ์เพลง ดูพร็อพเพอร์ตี้มาร์กอัปรูปภาพ
creator Organization หรือ Person แนะนำหากครีเอเตอร์มีความสนใจสูง ใช้พร็อพเพอร์ตี้นี้เพื่อระบุเพลย์ลิสต์ที่สร้างโดยบริการของคุณ (ประเภทเป็น Organization ที่มีพร็อพเพอร์ตี้ name ที่ระบุบริการของคุณ) หรือผู้ใช้ที่มีความสนใจสูงในบริการของคุณ (ประเภทเป็น Person ที่มีพร็อพเพอร์ตี้ name ที่ระบุผู้ใช้ที่มีความสนใจ)
keywords Text รายการคีย์เวิร์ด ("ร็อค" "ป๊อป") อารมณ์ ("มีความสุข" "อารมณ์เสีย") กิจกรรม ("ออกกำลังกาย" "ผ่อนคลาย") หรือคำอื่นๆ ที่เกี่ยวข้องกับเพลย์ลิสต์
description Text คำอธิบายสั้นๆ ของเพลย์ลิสต์ จำนวนอักขระสูงสุด 300 ตัว
isFamilyFriendly บูลีน ระบุว่าเนื้อหานี้เหมาะสำหรับครอบครัวหรือไม่ (กล่าวคือ เนื้อหาเหมาะสำหรับสมาชิกทุกคนในครอบครัว รวมถึงเด็กๆ ด้วย) ผลิตภัณฑ์ของ Google อาจใช้ isFamilyFriendly เมื่อเลือกเพลงที่จะเล่น
popularityScore PopularityScoreSpecification แนะนำอย่างยิ่ง เหตุผล คะแนนที่ 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."
}

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