พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของเหตุการณ์

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

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

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบ BCP 47 เช่น "en"
@type Text ต้องระบุ - ตั้งค่าเป็น SportsEvent เสมอ
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อก
  • แบบคงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ URL ของรายการจะเปลี่ยนแปลงก็ตาม) ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
name Text ต้องระบุ - ชื่อเหตุการณ์นี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
description Text คำอธิบายของเหตุการณ์นี้ จำนวนอักขระสูงสุด 300 ตัว ใช้อาร์เรย์เพื่อใส่คำอธิบายหลายภาษาและหลายความยาว
sport URL ต้องระบุ ลิงก์ไปยังหน้า Wikipedia (แนะนำเป็นเวอร์ชันภาษาอังกฤษ) ของกีฬา
startDate DateTime หรือ Date ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา โปรดทราบว่านี่คือเวลาเริ่มต้นจริงของกิจกรรม ไม่ใช่เวลาที่กิจกรรมออกอากาศทางทีวี
endDate DateTime หรือ Date เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
homeTeam SportsTeam แนะนำอย่างยิ่ง เหตุผล ทีมเหย้าของการแข่งขัน
homeTeam.name Text ต้องระบุ ชื่อเต็มของทีมกีฬา
homeTeam.sport URL ต้องระบุ ลิงก์ไปยังหน้า Wikipedia (แนะนำเป็นเวอร์ชันภาษาอังกฤษ) ของกีฬา
homeTeam.sameAs URL แนะนำอย่างยิ่ง เหตุผล URL ของหน้าเว็บอ้างอิงที่ระบุทีมได้ เช่น หน้า Wikipedia ของทีม
homeTeam.athlete Person คําอธิบายประกอบสำหรับนักกีฬาแต่ละคนในทีม
homeTeam.athlete.name Text ชื่อและนามสกุลของนักกีฬา
homeTeam.parentOrganization.name SportsOrganization ต้องระบุ ชื่อลีกกีฬาที่ทีมเข้าร่วม เช่น National Basketball Association หรือ Major League Baseball โปรดทราบว่าไม่ควรใช้ช่องนี้สำหรับการประชุมของทีม
homeTeam.parentOrganization.sameAs URL แนะนำอย่างยิ่ง เหตุผล URL ของหน้าเว็บอ้างอิงที่ระบุลีกของทีมได้ เช่น หน้า Wikipedia ของลีก
awayTeam SportsTeam แนะนำอย่างยิ่ง เหตุผล ทีมเยือนของการแข่งขัน พร็อพเพอร์ตี้จะเหมือนกับ SportsEvent.homeTeam
competitor SportsTeam หรือ Person แนะนำอย่างยิ่ง เหตุผล หากไม่มีทีมเหย้าหรือทีมเยือน (เช่น การแข่งขันชกมวย การแข่งขันกีฬาโอลิมปิก) ให้ระบุผู้เข้าร่วมเป็นคู่แข่ง หากเป็น SportsTeam พร็อพเพอร์ตี้จะเหมือนกับ SportsEvent.homeTeam หากเป็น Person พร็อพเพอร์ตี้จะเหมือนกับออบเจ็กต์ Person อื่นๆ เช่น นักแสดงใน Movie
location สถานที่ หรือ เมือง สถานที่จัดกิจกรรม
location.name Text ต้องระบุ - ชื่อสถานที่
location.address PostalAddress ต้องระบุหาก @type ของสถานที่คือสถานที่ - ที่อยู่ของสถานที่ ไม่ควรใช้แอตทริบิวต์นี้หาก @type ของสถานที่ตั้งคือเมือง
location.address.streetAddress Text ที่อยู่ของสถานที่ตั้ง
location.address.addressLocality Text เมืองของสถานที่ตั้ง
location.address.addressRegion Text สถานะของสถานที่ตั้ง
location.address.postalCode Text รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry Text ประเทศในรูปแบบ ISO 3166
image ImageObject ต้องระบุสำหรับ Google TV - รูปภาพที่เกี่ยวข้องกับกิจกรรม แนะนำให้เป็นโปสเตอร์หรืออาร์ตเวิร์กแบนเนอร์อย่างเป็นทางการของกิจกรรม ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและพร็อพเพอร์ตี้ที่ไม่บังคับที่จะรวมไว้กับ image ได้ที่พร็อพเพอร์ตี้รูปภาพ
potentialAction การดำเนินการเพื่อรับชม ต้องระบุหากมี - Deep Link ที่เล่นการบันทึกการแข่งขันกีฬานี้ในวิดีโอออนดีมานด์ หากต้องการระบุ Deep Link สําหรับกิจกรรมสด ให้ใช้พร็อพเพอร์ตี้ publishedOn หรือ potentialAction ใน BroadcastEvent แทน
identifier PropertyValue แนะนำอย่างยิ่ง เหตุผล - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ ดูรายละเอียดได้ในส่วนพร็อพเพอร์ตี้ตัวระบุ

ตัวอย่าง SportsEvent

ตัวอย่างที่ 1

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

ตัวอย่างที่ 2

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

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

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบ BCP 47 เช่น "en"
@type Text ต้องระบุ - ตั้งค่าเป็น MusicEvent เสมอ
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อก
  • คงที่
  • ในรูปแบบของ Unified Resource Identifier (URI)
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
name Text ต้องระบุ - ชื่อเหตุการณ์นี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
description Text คำอธิบายกิจกรรม จำนวนอักขระสูงสุด 300 ตัว ใช้อาร์เรย์เพื่อใส่คำอธิบายหลายภาษาและหลายความยาว
attendee Organization หรือ Person บุคคลหรือองค์กรที่เข้าร่วมกิจกรรม
startDate วันที่ ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
endDate วันที่ เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
composer Organization หรือ Person บุคคลหรือองค์กรที่เขียนบทประพันธ์ หรือเป็นผู้ประพันธ์ผลงานที่แสดงในบางกิจกรรม
performer Organization หรือ Person ต้องระบุ - ผู้แสดงในงาน เช่น ผู้นำเสนอ นักดนตรี กลุ่มดนตรี หรือนักแสดง
subEvent เหตุการณ์ เหตุการณ์ที่เป็นส่วนหนึ่งของกิจกรรมนี้ เช่น กิจกรรมการประชุมมีงานนำเสนอหลายรายการ ซึ่งแต่ละรายการเป็นเหตุการณ์ย่อยของการประชุม
superEvent เหตุการณ์ กิจกรรมที่เหตุการณ์นี้เป็นส่วนหนึ่งของกิจกรรม ตัวอย่างเช่น คอลเล็กชันการแสดงดนตรีแต่ละรายการอาจมีเทศกาลดนตรีเป็น SuperEvent
location สถานที่ หรือ เมือง ต้องระบุ - สถานที่จัดกิจกรรม
location.name Text ต้องระบุ - ชื่อสถานที่
location.address PostalAddress ต้องระบุหาก @type ของสถานที่คือสถานที่ - ที่อยู่ของสถานที่ ไม่ควรใช้แอตทริบิวต์นี้หาก @type ของสถานที่ตั้งคือเมือง
location.address.streetAddress Text ที่อยู่ของสถานที่ตั้ง
location.address.addressLocality Text เมืองของสถานที่ตั้ง
location.address.addressRegion Text สถานะของสถานที่ตั้ง
location.address.postalCode Text รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry Text ประเทศในรูปแบบ ISO 3166
workPerformed CreativeWork ผลงานที่แสดงในบางกิจกรรม เช่น ละครที่แสดงใน TheaterEvent

ตัวอย่าง MusicEvent

MusicEvent

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

ตารางข้อกําหนดของเหตุการณ์

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบ BCP 47 เช่น "en"
@type Text ต้องระบุ - ตั้งค่าเป็น Event เสมอ
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อก
  • คงที่
  • ในรูปแบบของ Unified Resource Identifier (URI)
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
name Text ต้องระบุ - ชื่อเหตุการณ์นี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
description Text คำอธิบายกิจกรรม จำนวนอักขระสูงสุด 300 ตัว ใช้อาร์เรย์เพื่อใส่คำอธิบายหลายภาษาและหลายความยาว
attendee Organization หรือ Person บุคคลหรือองค์กรที่เข้าร่วมกิจกรรม
startDate วันที่ ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
endDate วันที่ เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
subEvent เหตุการณ์ เหตุการณ์ที่เป็นส่วนหนึ่งของกิจกรรมนี้ เช่น กิจกรรมการประชุมมีงานนำเสนอหลายรายการ ซึ่งแต่ละรายการเป็นเหตุการณ์ย่อยของการประชุม
superEvent เหตุการณ์ กิจกรรมที่เหตุการณ์นี้เป็นส่วนหนึ่งของกิจกรรม ตัวอย่างเช่น คอลเล็กชันการแสดงดนตรีแต่ละรายการอาจมีเทศกาลดนตรีเป็น SuperEvent
releasedEvent PublicationEvent, FeaturedEvent หรือ ExclusiveEvent แนะนำอย่างยิ่ง เหตุผล - PublicationEvent ใช้เพื่อระบุการเผยแพร่เนื้อหาครั้งแรก (ทั่วโลกหรือในประเทศ) โดยผู้เผยแพร่ เช่น วันที่เผยแพร่ภาพยนตร์ครั้งแรกในโรงภาพยนตร์

นอกจากนี้ ให้ใช้ FeaturedEvent เพื่อระบุว่าบริการของคุณทําการตลาดเนื้อหานี้ว่าเป็นเนื้อหาต้นฉบับ แนะนํา พิเศษ และอื่นๆ

ExclusiveEvent ระบุว่าบริการของคุณมีสิทธิ์จัดจําหน่ายแต่เพียงผู้เดียว รวมถึงระบุสถานที่และเวลา

ดูรายละเอียดและตัวอย่างได้ที่ส่วนตัวอย่าง
releasedEvent.@type Text ต้องระบุ - โปรดตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าใดค่าหนึ่งต่อไปนี้เสมอ
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location ประเทศ ต้องระบุ - ภูมิภาคที่เชื่อมโยงกับกิจกรรมนี้

สำหรับ PublicationEvent จะเป็นภูมิภาคที่เผยแพร่เนื้อหา

สำหรับ FeaturedEvent และ ExclusiveEvent จะเป็นภูมิภาคที่เนื้อหาแสดงหรือมีเอกสิทธิ์

ใช้รหัส ISO 3166 สำหรับประเทศ หากต้องการระบุทุกที่ในโลก ให้ตั้งค่าเป็น EARTH
releasedEvent.startDate Date หรือ DateTime แนะนำ - ต้องระบุสำหรับ ExclusiveEvent - วันที่เริ่มต้นเผยแพร่เนื้อหา

สำหรับ PublicationEvent ฟิลด์นี้จะระบุวันที่เผยแพร่ครั้งแรกของเนื้อหา เช่น วันที่ภาพยนตร์เข้าฉายในโรงภาพยนตร์เป็นครั้งแรก

สำหรับ ExclusiveEvent และ FeaturedEvent ฟิลด์นี้จะระบุวันที่เริ่มต้นที่เนื้อหามีเอกสิทธิ์หรือแสดง
releasedEvent.endDate Date หรือ DateTime แนะนำ - ต้องระบุสำหรับ ExclusiveEvent - ใช้ได้กับประเภท ExclusiveEvent และ FeaturedEvent เท่านั้น

สำหรับ ExclusiveEvent ฟิลด์นี้จะแสดงวันที่ที่สิทธิ์ในเนื้อหาหมดอายุ

สำหรับ FeaturedEvent ฟิลด์นี้จะแสดงวันที่สุดท้ายที่ผู้ให้บริการแสดงเนื้อหา

หากเนื้อหามีเอกสิทธิ์หรือแสดงอย่างถาวร ให้ตั้งค่า endDate เป็น 20 ปีนับจากวันที่ปัจจุบัน
releasedEvent.publishedBy Organization หรือ Person ไม่บังคับ - องค์กรหรือบุคคลที่เผยแพร่เอนทิตีนี้
location สถานที่ หรือ เมือง ต้องระบุ - สถานที่จัดกิจกรรม โปรดทราบว่าคุณระบุ Place ได้ในระดับ City
location.name Text ต้องระบุ - ชื่อสถานที่
location.address PostalAddress ต้องระบุหาก @type ของสถานที่คือสถานที่ - ที่อยู่ของสถานที่ ไม่ควรใช้แอตทริบิวต์นี้หาก @type ของสถานที่ตั้งคือเมือง
location.address.streetAddress Text ที่อยู่ของสถานที่ตั้ง
location.address.addressLocality Text เมืองของสถานที่ตั้ง
location.address.addressRegion Text สถานะของสถานที่ตั้ง
location.address.postalCode Text รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry Text ประเทศในรูปแบบ ISO 3166
workPerformed CreativeWork ผลงานที่แสดงในบางกิจกรรม เช่น ละครที่แสดงใน TheaterEvent

ตัวอย่างเหตุการณ์

กิจกรรม

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}