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

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

การให้ TVSeason เป็นเอนทิตีแบบเต็มเป็นตัวเลือกที่ไม่บังคับ โปรดดูรายละเอียดในส่วนความสัมพันธ์ระหว่าง TVSeries, TVSeason และ TVEpisode

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

TVSeries

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • โดยที่"xx" แสดงถึงภาษาของสตริงในฟีด บริบทเอนทิตีรูทแต่ละรายการควรตั้งค่า @language เป็นรหัสภาษาที่เหมาะสมในรูปแบบ BCP 47 เช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาของคำบรรยาย/เสียงพากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น TVSeries เสมอ
@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 ได้
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
name Text ต้องระบุ - ชื่อรายการ
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงผลงานภาพยนตร์หรือโทรทัศน์ในระดับทั่วไป/นามธรรมที่สุด

ตัวอย่างเช่น titleEIDR สำหรับ TVSeries ที่รู้จักกันในชื่อ "Game of Thrones" คือ "10.5240/C1B5-3BA1-8991-A571-8472-W"
potentialAction การดำเนินการเพื่อรับชม ต้องระบุหากมี - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหามีให้บริการบนวิดีโอออนดีมานด์ (VoD) คุณต้องใช้พร็อพเพอร์ตี้นี้ โดยออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุDeep Link ของเนื้อหา
  • หากเนื้อหามีอยู่ในช่อง LiveTV คุณจะใช้พร็อพเพอร์ตี้นี้หรือไม่ก็ได้ โดยเอนทิตี BroadcastService ที่เชื่อมโยงจะระบุ Deep Link ของช่องแทน
  • TVSeries พร้อมให้บริการทั้งใน VOD และ LiveTV
ใช้อาร์เรย์เพื่อระบุ Deep Link ที่แตกต่างกันในหลายภูมิภาค ดูตัวอย่างหลายภูมิภาคและหลายภาษา
sameAs URL แนะนำอย่างยิ่ง เหตุผล URL ไปยังหน้าเว็บอ้างอิงที่ระบุรายการได้ เช่น หน้า Wikipedia ของรายการ ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
inLanguage Text ภาษาต้นฉบับของซีรีส์ในรูปแบบ BCP 47
genre Text รายการประเภทที่เกี่ยวข้องทั้งหมดที่จัดเรียงตามลําดับ เช่น ["Action", "Fashion", "Environment", "Football"]
keywords Text คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ คุณยังใช้อาร์เรย์คีย์เวิร์ดได้ด้วย เช่น ["feature, biography"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
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 ไม่บังคับ - องค์กรหรือบุคคลที่เผยแพร่เอนทิตีนี้
description Text แนะนำอย่างยิ่ง เหตุผล ข้อมูลสรุปของรายการ ขอแนะนำให้ใช้เรื่องย่อแทนการสรุปข้อเท็จจริง จำนวนอักขระสูงสุด 300 ตัว
actor Person หรือ PerformingGroup หรือ PerformanceRole แนะนำอย่างยิ่ง เหตุผล อาร์เรย์ของนักแสดงในซีรีส์ ดูคําแนะนําการประมาณที่นี่
director Person แนะนำอย่างยิ่ง เหตุผล ผู้กำกับรายการ
producer Organization หรือ Person แนะนำอย่างยิ่ง เหตุผล โปรดิวเซอร์ของรายการ
image ImageObject ต้องระบุสำหรับ Google TV - รูปภาพที่เกี่ยวข้องกับซีรีส์ ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและพร็อพเพอร์ตี้ที่ไม่บังคับที่จะรวมไว้กับ image ได้ที่พร็อพเพอร์ตี้รูปภาพ
trailer.description Text คำอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง
trailer.inLanguage Text ภาษาของตัวอย่างเพลงในรูปแบบ BCP 47
trailer.url URL URL ของตัวอย่างภาพยนตร์ที่โฮสต์แบบสาธารณะและอัปโหลดโดยสตูดิโอโปรดักชันหรือแหล่งที่มาที่ได้รับอนุญาตที่เกี่ยวข้อง
trailer.regionsAllowed สถานที่ ภูมิภาคที่อนุญาตให้มีสื่อ หากไม่ได้ระบุไว้ ระบบจะถือว่าอนุญาตทุกภูมิภาค ระบุประเทศในรูปแบบ ISO 3166
identifier PropertyValue แนะนำอย่างยิ่ง เหตุผล - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ ดูรายละเอียดได้ในส่วนพร็อพเพอร์ตี้ตัวระบุ
popularityScore PopularityScoreSpecification แนะนำอย่างยิ่ง เหตุผล คะแนนที่ Google ใช้ร่วมกับสัญญาณอื่นๆ เพื่อพิจารณาว่าควรเล่นสื่อใดให้ผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อก ดังนั้นรูปแบบการให้คะแนนจึงต้องสอดคล้องกันในทุกฟีดและสำหรับเอนทิตีทั้งหมดในแคตตาล็อก โดยค่าเริ่มต้น ระบบจะตั้งค่าคะแนนความนิยมของเอนทิตีเป็น 0
popularityScore.@type Text ตั้งค่าเป็น PopularityScoreSpecification เสมอ
popularityScore.value Number ค่าตัวเลขที่ไม่ใช่ค่าลบซึ่งระบุความนิยมของเอนทิตี โดยคะแนนที่สูงกว่าหมายถึงความนิยมที่สูงขึ้น
popularityScore.eligibleRegion ประเทศ ภูมิภาคที่ใช้คะแนนความนิยมนี้ได้ หากคะแนนความนิยมใช้ได้ทั่วโลก ให้ตั้งค่าเป็น EARTH โดยค่าเริ่มต้น ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น EARTH
Note: ความนิยมเฉพาะภาษาจะมีลำดับความสำคัญเหนือความนิยมทั่วโลก (EARTH)
review รีวิว ตรวจสอบการจัดประเภทของซีรีส์
review.reviewRating การจัดประเภท ต้องระบุหากระบุ review ใช้เพื่อระบุคะแนนที่ให้ในรีวิว
contentRating Text หรือ Rating ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และแนะนำอย่างยิ่งให้ระบุหากไม่ใช่เนื้อหาสำหรับผู้ใหญ่ - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับรูปแบบ 2 รูปแบบต่อไปนี้
  • โดยหน่วยงานจัดประเภทจะใส่ไว้ข้างหน้าคะแนนโดยมีเว้นวรรคคั่นไว้ เช่น ควรอธิบายการจัดประเภท "TV-MA" จากหน่วยงาน "TVPG" ในสหรัฐอเมริกาเป็น "TVPG TV-MA" ดูรายชื่อเอเจนซี
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทเนื้อหา
contentRating.author องค์กร ต้องระบุหาก contentRating ใช้ Rating - ชื่อของหน่วยงานจัดประเภท ดูรายชื่อหน่วยงานการจัดประเภทที่ยอมรับได้ที่หน้าหน่วยงานการจัดประเภทเนื้อหา
contentRating.ratingValue Text ต้องระบุหาก contentRating ใช้ Rating - ค่าการจัดประเภท
contentRating.advisoryCode Text รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับได้ ได้แก่ D, FV, L, S และ V โดย D = การสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ และ V = ความรุนแรง

TVEpisode

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • โดยที่"xx" แสดงถึงภาษาของสตริงในฟีด บริบทเอนทิตีรูทแต่ละรายการควรตั้งค่า @language เป็นรหัสภาษาที่เหมาะสมในรูปแบบ BCP 47 เช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาของคำบรรยาย/เสียงพากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น TVEpisode เสมอ
@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 ได้
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
name Text ต้องระบุ - ชื่อตอน
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างการนำเสนอหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงผลงานภาพยนตร์หรือโทรทัศน์ในระดับทั่วไป/นามธรรมที่สุด

ตัวอย่างเช่น titleEIDR สำหรับตอนแรกของซีซันแรกของ TVSeries ที่รู้จักกันในชื่อ "Game of Thrones" คือ "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X"
editEIDR Text แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงฉบับตัดต่อ / ฉบับที่เฉพาะเจาะจงสำหรับผลงานภาพยนตร์หรือโทรทัศน์

ตัวอย่างเช่น ตอนแรกของซีซันแรกของ TVSeries ที่รู้จักกันในชื่อ "Game of Thrones" ซึ่งมี titleEIDR เป็น "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X" มีการแก้ไข 1 ครั้ง เช่น "10.5240/FB97-C847-2969-D0AB-ECD1-C" ต้องมีพร็อพเพอร์ตี้

titleEIDR เมื่อระบุ editEIDR
inLanguage Text ภาษาต้นฉบับของซีรีส์ในรูปแบบ BCP 47
episodeNumber จำนวนเต็ม ต้องระบุ - ตัวเลขที่ระบุตำแหน่งของตอนนี้ตามลำดับของตอนในซีซัน episodeNumber ต้องเริ่มต้นใหม่สำหรับแต่ละซีซัน กล่าวคือ ตอนแรกของแต่ละซีซันต้องเป็น 1
partOfSeason TVSeason ต้องระบุ - ซีซันของรายการทีวีที่ตอนนี้อยู่

แม้ว่า TVEpisode จะไม่มี TVSeason ที่เกี่ยวข้อง คุณก็ยังคงต้องระบุพร็อพเพอร์ตี้ partOfSeason.@id และ partOfSeason.seasonNumber วิธีแก้ปัญหามีดังนี้
  • ใช้ partofSeries.@id (เช่น http://www.example.com/my_favorite_tv_show) และแนบช่องการค้นหาตัวยึดตําแหน่ง (เช่น ?season1) เพื่อสร้าง partOfSeason.@id ที่ไม่ซ้ำกัน (เช่น http://www.example.com/my_favorite_tv_show?season1)
  • ตั้งค่า partOfSeason.seasonNumber เป็น 1
partOfSeason.@type Text ต้องระบุ - ตั้งค่าเป็น TVSeason เสมอ
partOfSeason.@id URL ต้องระบุ - @id ของ TVSeason ที่ตอนนี้เป็นส่วนหนึ่งของรายการ
partOfSeason.seasonNumber จำนวนเต็ม ต้องระบุ - ตัวเลขที่ระบุตำแหน่งของซีซันนี้ตามลำดับของซีซันในซีรีส์ทีวี
partOfSeries TVSeries ต้องระบุ - ซีรีส์ทีวีที่ตอนนี้อยู่
partOfSeries.@type Text ต้องระบุ - ตั้งค่าเป็น TVSeries เสมอ
partOfSeries.@id URL ต้องระบุ - @id ของ TVSeries ที่ตอนนี้เป็นส่วนหนึ่งของรายการ
partOfSeries.name Text ต้องระบุ - ชื่อซีรีส์
partOfSeries.sameAs Text URL ไปยังหน้าเว็บอ้างอิงที่ระบุรายการได้ เช่น หน้า Wikipedia ของรายการ ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
potentialAction การดำเนินการเพื่อรับชม ต้องระบุหากมี - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหามีให้บริการบนวิดีโอออนดีมานด์ (VoD) คุณต้องใช้พร็อพเพอร์ตี้นี้ โดยออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุDeep Link ของเนื้อหา
  • หากเนื้อหามีอยู่ในช่อง LiveTV คุณจะใช้พร็อพเพอร์ตี้นี้หรือไม่ก็ได้ โดยเอนทิตี BroadcastService ที่เชื่อมโยงจะระบุ Deep Link ของช่องแทน
  • TVEpisode พร้อมให้บริการทั้งใน VOD และ LiveTV
ใช้อาร์เรย์เพื่อระบุ Deep Link ที่แตกต่างกันในหลายภูมิภาค ดูตัวอย่างหลายภูมิภาคและหลายภาษา
sameAs แนะนำอย่างยิ่ง เหตุผล URL URL ไปยังหน้าเว็บอ้างอิงที่ระบุตอนได้ เช่น หน้า Wikipedia ของตอน ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
duration ระยะเวลา รันไทม์ของตอนในรูปแบบ ISO 8601 โปรดใช้รูปแบบ "PT00H00M"
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 ไม่บังคับ - องค์กรหรือบุคคลที่เผยแพร่เอนทิตีนี้
description Text แนะนำอย่างยิ่ง เหตุผล ข้อมูลสรุปของตอน ขอแนะนำให้ใช้เรื่องย่อแทนการสรุปข้อเท็จจริง จำนวนอักขระสูงสุด 300 ตัว
genre Text รายการประเภทที่เกี่ยวข้องทั้งหมดที่จัดเรียงตามลําดับ เช่น ["Action", "Fashion", "Environment", "Football"]
keywords Text คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ คุณยังใช้อาร์เรย์คีย์เวิร์ดได้ด้วย เช่น ["feature, biography"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
actor Person หรือ PerformingGroup หรือ PerformanceRole แนะนำอย่างยิ่ง เหตุผล อาร์เรย์ของนักแสดงในตอนนั้น ดูคําแนะนําการประมาณที่นี่
director Person แนะนำอย่างยิ่ง เหตุผล ผู้กำกับตอน
producer Organization หรือ Person แนะนำอย่างยิ่ง เหตุผล โปรดิวเซอร์ของซีซัน
image ImageObject แนะนำอย่างยิ่ง เหตุผลสำหรับ Google TV - รูปภาพต่างๆ ที่เกี่ยวข้องกับ TVEpisode ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและพร็อพเพอร์ตี้ที่ไม่บังคับที่จะรวมไว้กับ image ได้ที่พร็อพเพอร์ตี้รูปภาพ
trailer.description Text คำอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง
trailer.inLanguage Text ภาษาของตัวอย่างเพลงในรูปแบบ BCP 47
trailer.url URL URL ของตัวอย่างภาพยนตร์ที่โฮสต์แบบสาธารณะและอัปโหลดโดยสตูดิโอโปรดักชันหรือแหล่งที่มาที่ได้รับอนุญาตที่เกี่ยวข้อง
trailer.regionsAllowed สถานที่ ภูมิภาคที่อนุญาตให้มีสื่อ หากไม่ได้ระบุไว้ ระบบจะถือว่าได้รับอนุญาตทุกภูมิภาค ระบุประเทศในรูปแบบ ISO 3166
review รีวิว ตรวจสอบการจัดประเภทของตอนทีวี
review.reviewRating การจัดประเภท ต้องระบุหากระบุ review ใช้เพื่อระบุคะแนนที่ให้ในรีวิว
contentRating Text หรือ Rating ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และแนะนำอย่างยิ่งให้ระบุหากไม่ใช่เนื้อหาสำหรับผู้ใหญ่ - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับรูปแบบ 2 รูปแบบต่อไปนี้
  • โดยหน่วยงานจัดประเภทจะใส่ไว้ข้างหน้าคะแนนโดยมีเว้นวรรคคั่นไว้ เช่น ควรอธิบายการจัดประเภท "TV-MA" จากหน่วยงาน "TVPG" ในสหรัฐอเมริกาเป็น "TVPG TV-MA" ดูรายชื่อเอเจนซี
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทเนื้อหา
contentRating.author องค์กร ต้องระบุหาก contentRating ใช้ Rating - ชื่อของหน่วยงานจัดประเภท ดูรายชื่อหน่วยงานการจัดประเภทที่ยอมรับได้ที่หน้าหน่วยงานการจัดประเภทเนื้อหา
contentRating.ratingValue Text ต้องระบุหาก contentRating ใช้ Rating - ค่าการจัดประเภท
contentRating.advisoryCode Text รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับได้ ได้แก่ D, FV, L, S และ V โดย D = การสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ และ V = ความรุนแรง
identifier PropertyValue แนะนำอย่างยิ่ง เหตุผล - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ โปรดดูรายละเอียดในส่วนพร็อพเพอร์ตี้ตัวระบุ
popularityScore PopularityScoreSpecification แนะนำอย่างยิ่ง เหตุผล คะแนนที่ Google ใช้ร่วมกับสัญญาณอื่นๆ เพื่อพิจารณาว่าควรเล่นสื่อใดให้ผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อก ดังนั้นรูปแบบการให้คะแนนจึงต้องสอดคล้องกันในทุกฟีดและสำหรับเอนทิตีทั้งหมดในแคตตาล็อก โดยค่าเริ่มต้น ระบบจะตั้งค่าคะแนนความนิยมของเอนทิตีเป็น 0
popularityScore.@type Text ตั้งค่าเป็น PopularityScoreSpecification เสมอ
popularityScore.value Number ค่าตัวเลขที่ไม่ใช่ค่าลบซึ่งระบุความนิยมของเอนทิตี โดยคะแนนที่สูงกว่าหมายถึงความนิยมที่สูงขึ้น
popularityScore.eligibleRegion ประเทศ ภูมิภาคที่ใช้คะแนนความนิยมนี้ได้ หากคะแนนความนิยมใช้ได้ทั่วโลก ให้ตั้งค่าเป็น EARTH โดยค่าเริ่มต้น ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น EARTH
Note: ความนิยมเฉพาะภาษาจะมีลำดับความสำคัญเหนือความนิยมทั่วโลก (EARTH)

TVSeason

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • โดยที่"xx" แสดงถึงภาษาของสตริงในฟีด บริบทเอนทิตีรูทแต่ละรายการควรตั้งค่า @language เป็นรหัสภาษาที่เหมาะสมในรูปแบบ BCP 47 เช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาของคำบรรยาย/เสียงพากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น TVSeason เสมอ
@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 ได้
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
name Text ต้องระบุ - ชื่อซีซันของรายการทีวีนี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างการนำเสนอหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงผลงานภาพยนตร์หรือโทรทัศน์ในระดับทั่วไป/นามธรรมที่สุด

ตัวอย่างเช่น titleEIDR สำหรับซีซันแรกของ TVSeries ที่รู้จักกันในชื่อ "Game of Thrones" คือ "10.5240/FD91-C72C-4161-FCBA-058B-1"
seasonNumber จำนวนเต็ม ต้องระบุ - ตัวเลขที่ระบุตำแหน่งของซีซันนี้ตามลำดับของซีซันในซีรีส์ทีวี
partOfSeries TVSeries ต้องระบุ - ซีรีส์ทีวีที่ซีซันนี้อยู่
partOfSeries.@type Text ต้องระบุ - ตั้งค่าเป็น TVSeries เสมอ
partOfSeries.@id URL ต้องระบุ - @id ของ TVSeries ที่ซีซันนี้อยู่
partOfSeries.name Text ต้องระบุ - ชื่อซีรีส์
partOfSeries.sameAs Text URL ไปยังหน้าเว็บอ้างอิงที่ระบุรายการได้ เช่น หน้า Wikipedia ของรายการ ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
potentialAction การดำเนินการเพื่อรับชม ต้องระบุหากมี - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหามีให้บริการบนวิดีโอออนดีมานด์ (VoD) คุณต้องใช้พร็อพเพอร์ตี้นี้ โดยออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุDeep Link ของเนื้อหา
  • หากเนื้อหามีอยู่ในช่อง LiveTV คุณจะใช้พร็อพเพอร์ตี้นี้หรือไม่ก็ได้ โดยเอนทิตี BroadcastService ที่เชื่อมโยงจะระบุ Deep Link ของช่องแทน
  • TVSeason พร้อมให้บริการทั้งใน VOD และ LiveTV
ใช้อาร์เรย์เพื่อระบุ Deep Link ที่แตกต่างกันในหลายภูมิภาค ดูตัวอย่างหลายภูมิภาคและหลายภาษา
sameAs URL แนะนำอย่างยิ่ง เหตุผล URL ไปยังหน้าเว็บอ้างอิงที่ระบุฤดูกาลได้ เช่น หน้า Wikipedia ของฤดูกาล ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
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 ไม่บังคับ - องค์กรหรือบุคคลที่เผยแพร่เอนทิตีนี้
description Text แนะนำอย่างยิ่ง เหตุผล เรื่องย่อของซีซัน ขอแนะนำให้ใช้เรื่องย่อแทนการสรุปข้อเท็จจริง จำนวนอักขระสูงสุด 300 ตัว
actor [Person or PerformingGroup or PerformanceRole แนะนำอย่างยิ่ง เหตุผล อาร์เรย์ของนักแสดงในซีซัน ดูคําแนะนําการประมาณที่นี่
director Person แนะนำอย่างยิ่ง เหตุผล อาร์เรย์ของผู้กำกับรายการ
producer Organization หรือ Person แนะนำอย่างยิ่ง เหตุผล โปรดิวเซอร์ของซีซัน
image ImageObject รูปภาพที่เกี่ยวข้องกับ TVSeason ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและพร็อพเพอร์ตี้ที่ไม่บังคับที่จะรวมไว้กับ image ได้ที่พร็อพเพอร์ตี้รูปภาพ
genre Text รายการประเภทที่เกี่ยวข้องทั้งหมดที่จัดเรียงตามลําดับ เช่น ["Action", "Fashion", "Environment", "Football"]
keywords Text คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ คุณยังใช้อาร์เรย์คีย์เวิร์ดได้ด้วย เช่น ["feature, biography"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
trailer.description Text คำอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง
trailer.inLanguage Text ภาษาของตัวอย่างเพลงในรูปแบบ BCP 47
trailer.url URL URL ของตัวอย่างภาพยนตร์ที่โฮสต์แบบสาธารณะและอัปโหลดโดยสตูดิโอโปรดักชันหรือแหล่งที่มาที่ได้รับอนุญาตที่เกี่ยวข้อง
trailer.regionsAllowed สถานที่ ภูมิภาคที่อนุญาตให้มีสื่อ หากไม่ได้ระบุไว้ ระบบจะถือว่าได้รับอนุญาตทุกภูมิภาค ระบุประเทศในรูปแบบ ISO 3166
identifier PropertyValue แนะนำอย่างยิ่ง เหตุผล - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ ดูรายละเอียดได้ในส่วนพร็อพเพอร์ตี้ตัวระบุ
popularityScore PopularityScoreSpecification แนะนำอย่างยิ่ง เหตุผล คะแนนที่ Google ใช้ร่วมกับสัญญาณอื่นๆ เพื่อพิจารณาว่าควรเล่นสื่อใดให้ผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อก ดังนั้นรูปแบบการให้คะแนนจึงต้องสอดคล้องกันในทุกฟีดและสำหรับเอนทิตีทั้งหมดในแคตตาล็อก โดยค่าเริ่มต้น ระบบจะตั้งค่าคะแนนความนิยมของเอนทิตีเป็น 0
popularityScore.@type Text ตั้งค่าเป็น PopularityScoreSpecification เสมอ
popularityScore.value Number ค่าตัวเลขที่ไม่ใช่ค่าลบซึ่งระบุความนิยมของเอนทิตี โดยคะแนนที่สูงกว่าหมายถึงความนิยมที่สูงขึ้น
popularityScore.eligibleRegion ประเทศ ภูมิภาคที่ใช้คะแนนความนิยมนี้ได้ หากคะแนนความนิยมใช้ได้ทั่วโลก ให้ตั้งค่าเป็น EARTH โดยค่าเริ่มต้น ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น EARTH
Note: ความนิยมเฉพาะภาษาจะมีลำดับความสำคัญเหนือความนิยมทั่วโลก (EARTH)
review รีวิว ตรวจสอบคะแนนของซีซันรายการทีวี
review.reviewRating การจัดประเภท ต้องระบุหากระบุ review ใช้เพื่อระบุคะแนนที่ให้ในรีวิว
contentRating Text หรือ Rating ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และแนะนำอย่างยิ่งให้ระบุหากไม่ใช่เนื้อหาสำหรับผู้ใหญ่ - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับรูปแบบ 2 รูปแบบต่อไปนี้
  • โดยหน่วยงานจัดประเภทจะใส่ไว้ข้างหน้าคะแนนโดยมีเว้นวรรคคั่นไว้ เช่น ควรอธิบายการจัดประเภท "TV-MA" จากหน่วยงาน "TVPG" ในสหรัฐอเมริกาเป็น "TVPG TV-MA" ดูรายชื่อเอเจนซี
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทเนื้อหา
contentRating.author องค์กร ต้องระบุหาก contentRating ใช้ Rating - ชื่อของหน่วยงานจัดประเภท ดูรายชื่อหน่วยงานการจัดประเภทที่ยอมรับได้ที่หน้าหน่วยงานการจัดประเภทเนื้อหา
contentRating.ratingValue Text ต้องระบุหาก contentRating ใช้ Rating - ค่าการจัดประเภท
contentRating.advisoryCode Text รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับได้ ได้แก่ D, FV, L, S และ V โดย D = การสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ และ V = ความรุนแรง

ข้อกำหนดของผู้ดำเนินการ

พร็อพเพอร์ตี้ actor ในประเภทเอนทิตี TVSeries, TVEpisode และ TVSeason ช่วยให้คุณระบุรายละเอียดเพิ่มเติมเกี่ยวกับนักแสดงได้ ซึ่งรวมถึงชื่อตัวละครและบทบาทที่แสดงในรายการทีวี ส่วนต่อไปนี้จะบันทึกข้อมูลเดียวกันนี้ พร้อมกับตัวอย่างที่ชี้แจงการใช้งาน

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
actor Person หรือ PerformingGroup หรือ PerformanceRole แนะนำอย่างยิ่ง เหตุผล : อาร์เรย์ของนักแสดง
  • ใช้ประเภท PerformanceRole เมื่อทราบบทบาทที่เล่นและ (ไม่บังคับ) ชื่อตัวละครของสมาชิกในทีม ในกรณีนี้ นักแสดง Person หรือ PerformingGroup จะฝังอยู่ภายในออบเจ็กต์ PerformanceRole
  • ใช้ประเภท Person เพื่อระบุนักแสดงแต่ละคน หรือ PerformingGroup เพื่อระบุรายละเอียดของกลุ่ม/วงดนตรีที่แสดงเมื่อไม่ทราบบทบาทที่สมาชิกในทีมแสดง

ใช้อาร์เรย์เพื่อแสดงบุคคล PerformingGroup หรือ PerformanceRoles หลายรายการ

การใช้ประเภท Person หรือ PerformingGroup

ระบุพร็อพเพอร์ตี้ต่อไปนี้เมื่อใช้ประเภท Person หรือ PerformingGroup

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@type Person หรือ PerformingGroup ต้องระบุ - ตั้งค่าเป็น Person หรือ PerformingGroup เสมอ
@id URL แนะนำอย่างยิ่ง เหตุผล - ตัวระบุนักแสดงหรือกลุ่มที่แสดงในรูปแบบ URI เช่น https://example.com/actor/abc @id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกต่อนักแสดง/กลุ่มที่แสดง
  • รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Uniform Resource Identifier (URI)
  • องค์กรต้องเป็นเจ้าของโดเมนที่ใช้สำหรับค่า @id

โปรดทราบว่า @id ที่ใช้ในพร็อพเพอร์ตี้นักแสดงควรใช้อย่างสอดคล้องกันตลอดทั้งฟีด เช่น หากมีภาพยนตร์ 2 เรื่องที่มีนักแสดงคนเดียวกัน ค่า @id ของออบเจ็กต์นักแสดงทั้ง 2 รายการนี้ควรเหมือนกัน

name Text ต้องระบุ - ชื่อนักแสดง/นักแสดงหญิง/สมาชิกในทีม/กลุ่มที่แสดง
sameAs URL แนะนำอย่างยิ่ง เหตุผล - URL ของหน้าเว็บอ้างอิงที่ระบุนักแสดงหรือกลุ่มนักแสดงได้ เช่น หน้า Wikipedia ของนักแสดง ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ @id

การใช้ประเภท PerformanceRole

ระบุพร็อพเพอร์ตี้ต่อไปนี้เมื่อใช้ประเภท PerformanceRole

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@type PerformanceRole ต้องระบุ - ตั้งค่าเป็น PerformanceRole เสมอ
roleName Text แนะนำอย่างยิ่ง เหตุผล - บทบาทที่สมาชิกนักแสดงแสดงหรือเล่น โปรดดูรายการค่าที่ยอมรับได้ที่นี่
characterName Text ชื่อตัวละครที่เล่นในบทบาทการแสดง อย่าตั้งค่าช่องนี้หากประเภทผู้ดําเนินการคือ PerformingGroup
actor Person หรือ PerformingGroup ต้องระบุ -
  • สมาชิกในทีมนักแสดงของเนื้อหาเมื่อใช้ประเภทข้อมูล บุคคล
  • กลุ่ม/วงดนตรีที่แสดงของเนื้อหาเมื่อใช้ประเภทข้อมูล PerformingGroup
actor.@type Person หรือ PerformingGroup ต้องระบุ - ตั้งค่าเป็น Person หรือ PerformingGroup เสมอ
actor.@id URL แนะนำอย่างยิ่ง เหตุผล - ตัวระบุผู้ดำเนินการหรือกลุ่มที่ดำเนินการในรูปแบบ URI เช่น https://example.com/actor/abc @id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกต่อนักแสดง/กลุ่มที่แสดง
  • รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Uniform Resource Identifier (URI)
  • องค์กรต้องเป็นเจ้าของโดเมนที่ใช้สำหรับค่า @id

โปรดทราบว่า @id ที่ใช้ในพร็อพเพอร์ตี้นักแสดงควรใช้อย่างสอดคล้องกันตลอดทั้งฟีด เช่น หากมีภาพยนตร์ 2 เรื่องที่มีนักแสดงคนเดียวกัน ค่า @id ของออบเจ็กต์นักแสดงทั้ง 2 รายการนี้ควรเหมือนกัน

actor.name Text ต้องระบุ - ชื่อนักแสดง/นักแสดงหญิง/สมาชิกในทีม/กลุ่มที่แสดง
actor.sameAs URL แนะนำอย่างยิ่ง เหตุผล - URL ของหน้าเว็บอ้างอิงที่ระบุนักแสดงหรือกลุ่มนักแสดงได้ เช่น หน้า Wikipedia ของนักแสดง พร็อพเพอร์ตี้นี้ต้องแตกต่างจากพร็อพเพอร์ตี้ actor.@id

ชื่อบทบาทที่ยอมรับได้

ค่าเหล่านี้กำหนดให้ actor.@type เป็น Person

ค่า roleName คำอธิบาย
"Cameo" บทบาทการแสดงสั้นๆ หรือที่เรียกว่าการปรากฏตัวแบบจํากัดเวลาคือการปรากฏตัวสั้นๆ ของบุคคลที่มีชื่อเสียงในผลงานศิลปะการแสดง
"VoiceActor" การแสดงด้วยเสียงคือการใช้เสียงของนักแสดงแต่นักแสดงไม่ได้ปรากฏตัวบนหน้าจอ ปัญหานี้พบได้บ่อยที่สุดในแอนิเมชัน แต่ก็อาจเกิดขึ้นเมื่อมีการพากย์เสียงของนักแสดงทับเสียงพูดของนักแสดงอีกคน
"Double" นักแสดงแทนคือผู้ที่มาแทนที่นักแสดงคนอื่นๆ เพื่อไม่ให้เห็นใบหน้าของบุคคลนั้น
"MotionCaptureActor" MotionCaptureActor หมายถึงบุคคลที่บันทึกการเคลื่อนไหวของนักแสดง และนำข้อมูลดังกล่าวไปใช้สร้างโมเดลตัวละครดิจิทัลในภาพเคลื่อนไหวคอมพิวเตอร์ 2 มิติหรือ 3 มิติ

ค่าเหล่านี้เป็นที่ยอมรับโดยทั่วไปสำหรับประเภท Person และ PerformingGroup

ค่า roleName คำอธิบาย
"นักแสดง" นักแสดงคือบุคคลที่แสดงเป็นตัวละครในการแสดงผ่านสื่อดั้งเดิมอย่างโรงละคร หรือสื่อสมัยใหม่อย่างภาพยนตร์ วิทยุ และโทรทัศน์
"GuestStar" "ดารารับเชิญคือนักแสดงที่เล่นบทบาทสมมติและปรากฏตัวใน 1 หรือ 2 ตอน ในบางกรณี ดารารับเชิญอาจเล่นเป็นตัวละครสำคัญที่เกิดซ้ำและอาจปรากฏในซีรีส์หลายครั้ง แม้ว่าจะไม่ใช่สมาชิกของนักแสดงหลักก็ตาม ตั้งค่าเป็น "GuestStar" เมื่อนักแสดงมีการแสดงเป็นแขกรับเชิญหรือเป็นแขกรับเชิญในรายการ ควรระบุดารารับเชิญที่ระดับตอนเท่านั้น และไม่ควรเพิ่มที่ระดับ TVSeries
"ผู้มาเยือน" "แขกรับเชิญในรายการทอล์กโชว์ โปรดทราบว่า "GuestStar" เป็นบทบาทสมมติ แต่ "Guest" คือการปรากฏตัวในชีวิตจริง
"ผู้ประกาศ" ผู้ประกาศคือผู้ที่พูดเปิดและปิดรายการ แนะนำพิธีกร ผู้แข่งขัน และ/หรือแขกรับเชิญที่เป็นดารา อธิบายรางวัลที่มีให้ และเตรียมผู้ชมให้พร้อมก่อนการถ่ายทำ รวมถึงสร้างความบันเทิงให้ผู้ชมในช่วงพัก
"ผู้บรรยาย" ผู้บรรยายจะบรรยายเกมหรือการแข่งขันแบบเรียลไทม์ โดยปกติแล้วจะบรรยายระหว่างการถ่ายทอดสด
"อิมเพรสชันนิสต์" ผู้เลียนแบบหรือนักลอกเลียนแบบคือผู้แสดงที่เลียนแบบเสียง น้ำเสียง และท่าทางของคนดังและตัวละครการ์ตูน
"โฮสต์" บุคคลที่แนะนำ นำเสนอ หรือจัดรายการโทรทัศน์ โดยมักทำหน้าที่เป็นสื่อกลางระหว่างรายการกับผู้ชม โดยปกติแล้ว "ผู้จัด" จะเป็นบทบาทที่ไม่ใช่นิยาย
"ผู้ร่วมจัดการประชุม" บุคคลที่จัดกิจกรรม/โปรแกรมร่วมกับบุคคลอื่น
"GuestHost" ผู้จัดรับเชิญคือผู้จัด ซึ่งมักจะเป็นผู้จัดรายการทอล์กโชว์ ที่จะจัดรายการแทนผู้จัดปกติเมื่อไม่พร้อม
"ผู้ประกาศข่าว" ผู้นำเสนอ/แจ้งข้อมูลแก่สาธารณชนเกี่ยวกับข่าวและเหตุการณ์ที่เกิดขึ้นในระดับท้องถิ่น ระดับประเทศ และระดับนานาชาติผ่านรายการข่าวทางโทรทัศน์
"ผู้รายงาน" ผู้รายงานข่าวหรือผู้สื่อข่าวภาคสนามมักจะเป็นนักข่าวหรือผู้บรรยายของนิตยสาร หรือตัวแทนที่ส่งรายงานไปยังหนังสือพิมพ์ วิทยุ รายการข่าวทางโทรทัศน์ หรือบริษัทประเภทอื่นๆ จากสถานที่ห่างไกล
"ShowJudge" ผู้ตัดสินคือบุคคลที่มักได้รับการพิจารณาว่าเป็นผู้เชี่ยวชาญในสาขาของรายการ และได้รับบทบาท "ผู้ตัดสิน" เพื่อวิจารณ์ผู้เข้าแข่งขันที่ออดิชันและเข้าร่วมการแข่งขันของซีรีส์ทีวี
"ผู้ร่วมอภิปราย" สมาชิกของคณะกรรมการสนทนาหรือที่ปรึกษาของคณะกรรมการวิทยุหรือโทรทัศน์
"ผู้เข้าแข่งขัน" ผู้แข่งขันในการแข่งขันหรือเกมโชว์คือผู้ที่เข้าร่วมการแข่งขันหรือเกมโชว์นั้นๆ
"StoryNarrator" ผู้บรรยายคือผู้ที่บรรยายเรื่องราว โดยเฉพาะอย่างยิ่งตัวละครที่เล่าเหตุการณ์ในนวนิยายหรือบทกวีเชิงบรรยาย
"MusicalArtist" "ศิลปินเพลงอาจเป็นบุคคล กลุ่ม หรือตัวละครสมมติที่มักแสดงต่อหน้าผู้ชมเป็นประจำ หรือบันทึกแทร็กเพลงหรืออัลบั้มเพลงไว้ นักประพันธ์เพลงและผู้แต่งเนื้อร้องควรมีเครดิตประเภทนี้เฉพาะในกรณีที่เครดิตของผลงานเพลงบางรายการบอกเป็นนัยว่าบุคคลดังกล่าวมีส่วนร่วมในฐานะผู้แสดงหลักด้วย ประเภทนี้ใช้เพื่อเชื่อมโยงนักดนตรีหรือกลุ่มนักดนตรีถาวร รวมถึงนักดนตรีหรือกลุ่มนักดนตรีรับเชิญกับรายการได้

แยกความแตกต่างระหว่างบทบาทหลักและบทบาทสนับสนุนของนักแสดง

หากต้องการแยกความแตกต่างระหว่างนักแสดงหลัก/ประจำกับนักแสดงรับเชิญ/ตัวประกอบในรายการทีวี ให้เพิ่มนักแสดงหลักในเอนทิตี TVSeries เท่านั้น และเพิ่มเฉพาะนักแสดงรับเชิญหรือนักแสดงที่มีบทบาทสนับสนุนในเอนทิตี TVEpisode ตรวจสอบว่าไม่ได้เพิ่มนักแสดงหลัก/นักแสดงสมทบลงในเอนทิตี TVEpisode

ตัวอย่าง

ตัวอย่าง TVSeries, TVEpisode และ TVSeason

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

ตัวอย่างพร็อพเพอร์ตี้ Actor

ไม่ทราบบทบาทของนักแสดง

เมื่อไม่ทราบบทบาทของผู้แสดง เราขอแนะนำให้ระบุข้อมูลผู้แสดงโดยใช้ประเภท Person หรือ PerformingGroup

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

ทราบบทบาทของผู้ดําเนินการ

เมื่อทราบบทบาทของผู้แสดงแล้ว เราขอแนะนำให้ระบุข้อมูลผู้แสดงโดยใช้ประเภท PerformanceRole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

บทบาทที่รู้จักสำหรับกลุ่มย่อยของนักแสดง

เมื่อไม่ทราบข้อมูลเมตาของบทบาทในการแสดง เราขอแนะนำให้ระบุข้อมูลนักแสดงโดยใช้ประเภท บุคคล หรือ กลุ่มนักแสดง สําหรับกรณีที่ทราบข้อมูลนี้ ให้ใช้ประเภท PerformanceRole ประเภทเหล่านี้สามารถเพิ่มลงในอาร์เรย์เดียวกันได้

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

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