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

ส่วนนี้จะแสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี 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 ต้องนำไปยังหน้าคำอธิบายเนื้อหาที่ไม่ได้ถูกบล็อกโดยเพย์วอลล์
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
name Text ต้องระบุ - ชื่อเพลย์ลิสต์ เช่น "มิกซ์เพลงแจ๊สฟังก์"
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."
}

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