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

ส่วนนี้จะแสดงรายละเอียดพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี 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 ของรายการจะเปลี่ยนไปก็ตาม) โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้ใช้ url ของเอนทิตีเป็น @id โปรดดูรายละเอียดเพิ่มเติมในหัวข้อตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
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 - รูปภาพที่เกี่ยวข้องกับ TVSeries โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและที่ไม่บังคับที่จะรวมกับ 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 ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ หากไม่ใช่ แนะนำอย่างยิ่ง - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 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 ของรายการจะเปลี่ยนไปก็ตาม) โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้ใช้ url ของเอนทิตีเป็น @id โปรดดูรายละเอียดเพิ่มเติมในหัวข้อตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
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" ซึ่งมีชื่อเรื่อง EIDR เป็น "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 - รูปภาพต่างๆ ที่เกี่ยวข้องกับรายการทีวีตอน โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จำเป็นและที่ไม่บังคับที่จะรวมกับ image ที่หัวข้อคุณสมบัติของรูปภาพ
trailer.description Text คำอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง
trailer.inLanguage Text ภาษาของตัวอย่างในรูปแบบ BCP 47
trailer.url URL URL ของตัวอย่างที่โฮสต์แบบสาธารณะและอัปโหลดโดยสตูดิโอการผลิตที่เกี่ยวข้องหรือแหล่งที่มาที่ได้รับอนุญาต
trailer.regionsAllowed สถานที่ ภูมิภาคที่อนุญาตให้มีสื่อ หากไม่ระบุ ระบบจะถือว่าอนุญาตทุกพื้นที่ ระบุประเทศในรูปแบบ ISO 3166
review รีวิว ตรวจสอบการจัดประเภทสำหรับตอนของรายการทีวี
review.reviewRating การจัดประเภท ต้องระบุหากระบุ review ใช้เพื่อระบุคะแนนที่ให้ไว้ในรีวิว
contentRating ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ หากไม่ใช่ แนะนำอย่างยิ่ง - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 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 ของรายการจะเปลี่ยนไปก็ตาม) โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้ใช้ url ของเอนทิตีเป็น @id โปรดดูรายละเอียดเพิ่มเติมในหัวข้อตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
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 หรือ PerformingGroup หรือ 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 ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ หากไม่ใช่ แนะนำอย่างยิ่ง - การจัดประเภทเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 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 เพื่อระบุรายละเอียดของกลุ่ม/วงการแสดงเมื่อไม่ทราบบทบาทของนักแสดงที่เล่น

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

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

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

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

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

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 ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกต่อนักแสดง/กลุ่มผู้แสดง
  • รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • องค์กรของคุณต้องเป็นเจ้าของโดเมนที่ใช้สำหรับค่า @id

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

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

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

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

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

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

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

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

หากต้องการแยกความแตกต่างระหว่างนักแสดงรับเชิญ/แขกรับเชิญและนักแสดงรับเชิญ/นักแสดงร่วมในรายการทีวี ให้เพิ่มนักแสดงหลักในเอนทิตี 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"
      }
  }
]

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

เมื่อไม่รู้จักข้อมูลเมตาของบทบาทการแสดง เราขอแนะนำให้ระบุข้อมูลนักแสดงโดยใช้ประเภท Person หรือ PerformingGroup สำหรับอีกกรณีหนึ่งที่ทราบข้อมูลนี้ ให้ใช้ประเภท 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"
  }
]

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