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

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

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

พร็อพเพอร์ตี้ ประเภทที่คาดไว้ คำอธิบาย
@context ข้อความ จำเป็น - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบรูปแบบ BCP 47 เช่น "en"
@type ข้อความ จำเป็น - ตั้งค่าเป็น SportsEvent เสมอ
@id URL ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกของคุณ
  • คงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าคุณสมบัติ URL ของรายการจะเปลี่ยนแปลงไป) ระบบจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ทำงานได้
  • ในรูปแบบ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในการเป็นตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมในส่วนตัวระบุ
name ข้อความ ต้องระบุ - ชื่อของกิจกรรมนี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและภาษา
  • โปรดทราบว่าแต่ละภาษาจะรองรับเพียงชื่อเดียวเท่านั้น (คู่ภาษา-ประเทศ)
description ข้อความ คำอธิบายของกิจกรรมนี้ วรรณกรรม 300 อักขระ ใช้อาร์เรย์เพื่อรวมคำอธิบายในหลายภาษาและความยาว
sport URL ต้องระบุ ลิงก์ไปยังหน้า Wikipedia (แนะนำให้เป็นภาษาอังกฤษ) ของกีฬานั้นๆ
startDate DateTime หรือ Date ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา โปรดทราบว่านี่คือเวลาเริ่มต้นจริงของกิจกรรม ไม่ใช่เวลาที่กิจกรรมออกอากาศทางทีวี
endDate DateTime หรือ Date เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
homeTeam SportsTeam เหตุผลที่เราแนะนำอย่างยิ่ง ทีมเจ้าบ้านของทีม
homeTeam.name ข้อความ ต้องระบุ ชื่อเต็มของทีมกีฬา
homeTeam.sport URL ต้องระบุ ลิงก์ไปยังหน้า Wikipedia (แนะนำให้เป็นภาษาอังกฤษ) ของกีฬานั้นๆ
homeTeam.sameAs URL เหตุผลที่เราแนะนำอย่างยิ่ง URL ไปยังหน้าเว็บอ้างอิงที่สามารถระบุทีมได้ เช่น หน้า Wikipedia ของทีม
homeTeam.athlete Person คำอธิบายประกอบสำหรับนักกีฬาแต่ละคนในทีม
homeTeam.athlete.name ข้อความ ชื่อเต็มของนักกีฬา
homeTeam.parentOrganization.name SportsOrganization ต้องระบุ ชื่อลีกกีฬาที่ทีมเป็นสมาชิก เช่น สมาคมบาสเกตบอลแห่งชาติหรือเมเจอร์ลีกเบสบอล โปรดทราบว่าไม่ควรใช้ฟิลด์นี้สำหรับการประชุมของทีม
homeTeam.parentOrganization.sameAs URL เหตุผลที่เราแนะนำอย่างยิ่ง URL ไปยังหน้าเว็บอ้างอิงที่ระบุลีกของทีมได้ เช่น หน้า Wikipedia ของลีก
awayTeam SportsTeam เหตุผลที่เราแนะนำอย่างยิ่ง ทีมเยือนการแข่งขัน พร็อพเพอร์ตี้จะเหมือนกับ SportsEvent.homeTeam
competitor SportsTeamหรือบุคคล เหตุผลที่เราแนะนำอย่างยิ่ง หากทีมเหย้าหรือเยือนไม่เกี่ยวข้อง (เช่น การแข่งขันชกมวย โอลิมปิก) ให้ระบุผู้เข้าร่วมเป็นคู่แข่ง หากเป็น SportsTeam พร็อพเพอร์ตี้จะเหมือนกับ SportsEvent.homeTeam หากเป็น Person คุณสมบัติจะเหมือนกับออบเจ็กต์ Person อื่นๆ เช่น ตัวดำเนินการใน Movie
location สถานที่หรือเมือง สถานที่จัดกิจกรรม
location.name ข้อความ ต้องระบุ - ชื่อของสถานที่ตั้ง
location.address PostalAddress ต้องระบุหาก location @type คือ Place - ที่อยู่ของสถานที่ตั้ง ไม่ควรใช้ค่านี้หากตำแหน่ง @type คือเมือง
location.address.streetAddress ข้อความ ที่อยู่ถนนของสถานที่ตั้ง
location.address.addressLocality ข้อความ เมืองของสถานที่ตั้ง
location.address.addressRegion ข้อความ สถานะของสถานที่
location.address.postalCode ข้อความ รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry ข้อความ ประเทศในรูปแบบ ISO 3166
image ImageObject ต้องระบุสำหรับ Google TV - รูปภาพที่เกี่ยวข้องกับกิจกรรม แนะนำให้ใช้เป็นโปสเตอร์อย่างเป็นทางการหรือภาพแบนเนอร์ของกิจกรรม ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จําเป็นและไม่บังคับที่จะรวมไว้ใน image ได้ที่คุณสมบัติของรูปภาพ
potentialAction WatchAction ต้องระบุ (หากมี) - 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 ข้อความ จำเป็น - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบรูปแบบ BCP 47 เช่น "en"
@type ข้อความ จำเป็น - ตั้งค่าเป็น MusicEvent เสมอ
@id URL ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกของคุณ
  • คงที่
  • ในรูปแบบ Unified Resource Identifier (URI)
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในการเป็นตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมในส่วนตัวระบุ
name ข้อความ ต้องระบุ - ชื่อของกิจกรรมนี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและภาษา
  • โปรดทราบว่าแต่ละภาษาจะรองรับเพียงชื่อเดียวเท่านั้น (คู่ภาษา-ประเทศ)
description ข้อความ คำอธิบายของกิจกรรม วรรณกรรม 300 อักขระ ใช้อาร์เรย์เพื่อรวมคำอธิบายในหลายภาษาและความยาว
attendee Organization หรือ Person บุคคลหรือองค์กรที่เข้าร่วมกิจกรรม
startDate Date ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
endDate Date เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
composer Organization หรือ Person บุคคลหรือองค์กรที่แต่งบทประพันธ์เพลงหรือผู้เรียบเรียงผลงานที่ดำเนินการในกิจกรรมบางอย่าง
performer Organization หรือ Person ต้องระบุ - นักแสดงในกิจกรรม เช่น ผู้นำเสนอ นักดนตรี วงดนตรี หรือนักแสดง
subEvent เหตุการณ์ กิจกรรมที่เป็นส่วนหนึ่งของกิจกรรมนี้ ตัวอย่างเช่น กิจกรรมการประชุมมีงานนำเสนอหลายรายการ แต่ละรายการนับเป็นกิจกรรมย่อยของการประชุม
superEvent เหตุการณ์ กิจกรรมที่กิจกรรมนี้เข้าร่วม ตัวอย่างเช่น คอลเล็กชันการแสดงดนตรีแต่ละรายการอาจมีเทศกาลดนตรีเป็นกิจกรรมพิเศษ
location สถานที่หรือเมือง ต้องระบุ - ตำแหน่งของกิจกรรม
location.name ข้อความ ต้องระบุ - ชื่อของสถานที่ตั้ง
location.address PostalAddress ต้องระบุหาก location @type คือ Place - ที่อยู่ของสถานที่ตั้ง ไม่ควรใช้ค่านี้หากตำแหน่ง @type คือเมือง
location.address.streetAddress ข้อความ ที่อยู่ถนนของสถานที่ตั้ง
location.address.addressLocality ข้อความ เมืองของสถานที่ตั้ง
location.address.addressRegion ข้อความ สถานะของสถานที่
location.address.postalCode ข้อความ รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry ข้อความ ประเทศในรูปแบบ ISO 3166
workPerformed CreativeWork งานที่แสดงในกิจกรรมบางอย่าง เช่น การแสดงละครในโรงละครกิจกรรม

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

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

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

ดูส่วนตัวอย่างสำหรับรายละเอียดและตัวอย่าง
releasedEvent.@type ข้อความ จำเป็น - ตรวจสอบว่าได้ตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าใดค่าหนึ่งต่อไปนี้เสมอ
  • 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 ข้อความ ต้องระบุ - ชื่อของสถานที่ตั้ง
location.address PostalAddress ต้องระบุหาก location @type คือ Place - ที่อยู่ของสถานที่ตั้ง ไม่ควรใช้ข้อมูลนี้หากตำแหน่ง @type คือเมือง
location.address.streetAddress ข้อความ ที่อยู่ถนนของสถานที่ตั้ง
location.address.addressLocality ข้อความ เมืองของสถานที่ตั้ง
location.address.addressRegion ข้อความ สถานะของสถานที่
location.address.postalCode ข้อความ รหัสไปรษณีย์ของสถานที่ตั้ง
location.address.addressCountry ข้อความ ประเทศในรูปแบบ ISO 3166
workPerformed CreativeWork งานที่แสดงในกิจกรรมบางอย่าง เช่น การแสดงละครในโรงละครกิจกรรม

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

เหตุการณ์ 

{
  "@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"
  }
}