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

ส่วนนี้จะแสดงรายละเอียดพร็อพเพอร์ตี้ของมาร์กอัปเนื้อหาสําหรับเอนทิตีประเภท 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 รวบรวมข้อมูลได้
สําหรับลิงก์ในรายละเอียดของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
name Text ต้องระบุ - ชื่อของโชว์
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าชื่อภาษาจะเป็นภาษาเดียวต่อคู่ภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนําอย่างยิ่ง เพราะเหตุใด - ตัวระบุ EIDR (รีจิสทรีตัวระบุสื่อบันเทิง) ที่นําเสนอในระดับทั่วไป/นามธรรม ผลงานของภาพยนตร์หรือโทรทัศน์

ตัวอย่างเช่น titleEIDR สําหรับ TVSeries ชื่อ "Game of Thrones" คือ "10.5240/C1B5-3BA1-8991-A571-8472-W"
potentialAction การดำเนินการเพื่อรับชม ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหาพร้อมใช้งานในวิดีโอออนดีมานด์ (VoD) คุณต้องระบุพร็อพเพอร์ตี้นี้ ออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุลิงก์ในรายละเอียดของเนื้อหา
  • หากเนื้อหาพร้อมใช้งานในช่อง 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 คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ยังมีอาร์เรย์ของคีย์เวิร์ดด้วย ตัวอย่างเช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
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 ข้อกําหนดเฉพาะของความนิยม แนะนําอย่างยิ่ง เพราะเหตุใด คะแนนที่ 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 Text หรือ Organization ต้องระบุหาก 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 รวบรวมข้อมูลได้
สําหรับลิงก์ในรายละเอียดของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
name Text ต้องระบุ - ชื่อตอน
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างการนําเสนอหลายภาษา
  • โปรดทราบว่าชื่อภาษาจะเป็นภาษาเดียวต่อคู่ภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนําอย่างยิ่ง เพราะเหตุใด - ตัวระบุ EIDR (รีจิสทรีตัวระบุสื่อบันเทิง) ที่นําเสนอในระดับทั่วไป/นามธรรม ผลงานของภาพยนตร์หรือโทรทัศน์

ตัวอย่างเช่น 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-D"

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

แม้ว่า 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 ทีวีซีรีส์ จําเป็น - ซีรีส์ที่มีตอนนี้
partOfSeries.@type Text จําเป็น - ตั้งค่าเป็น TVSeries เสมอ
partOfSeries.@id URL ต้องระบุ - @id ของ TVSeries ที่มีตอนนี้เป็นส่วนหนึ่งของ
partOfSeries.name Text ต้องระบุ - ชื่อของซีรีส์
partOfSeries.sameAs Text URL ไปยังหน้าเว็บอ้างอิงที่สามารถระบุรายการได้ ตัวอย่างเช่น หน้า Wikipedia ของรายการ ต้องแตกต่างจากพร็อพเพอร์ตี้ url
potentialAction การดำเนินการเพื่อรับชม ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหาพร้อมใช้งานในวิดีโอออนดีมานด์ (VoD) คุณต้องระบุพร็อพเพอร์ตี้นี้ ออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุลิงก์ในรายละเอียดของเนื้อหา
  • หากเนื้อหาพร้อมใช้งานในช่อง 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 คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ยังมีอาร์เรย์ของคีย์เวิร์ดด้วย ตัวอย่างเช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
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 Text หรือ Organization ต้องระบุหาก contentRating ใช้ Rating - ชื่อของตัวแทนการให้คะแนน ดูหน้าเอเจนซีการจัดประเภทเนื้อหาเพื่อดูรายการเอเจนซีการจัดประเภทที่ยอมรับ
contentRating.ratingValue Text ต้องระบุหาก contentRating ใช้ Rating - ค่าของคะแนน
contentRating.advisoryCode Text รหัสคําแนะนําสําหรับเนื้อหา ค่าที่ยอมรับ ได้แก่ D, FV, L, S และ V. D = บทสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ, V = ความรุนแรง
identifier PropertyValue แนะนําอย่างยิ่ง เพราะเหตุใด - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ โปรดดูรายละเอียดในส่วนคุณสมบัติตัวระบุ
popularityScore ข้อกําหนดเฉพาะของความนิยม แนะนําอย่างยิ่ง เพราะเหตุใด คะแนนที่ 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 รวบรวมข้อมูลได้
สําหรับลิงก์ในรายละเอียดของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
name Text ต้องระบุ - ชื่อของซีซันรายการทีวีนี้
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างการนําเสนอหลายภาษา
  • โปรดทราบว่าชื่อภาษาจะเป็นภาษาเดียวต่อคู่ภาษา (คู่ภาษา-ประเทศ)
titleEIDR Text แนะนําอย่างยิ่ง เพราะเหตุใด - ตัวระบุ EIDR (รีจิสทรีตัวระบุสื่อบันเทิง) ที่นําเสนอในระดับทั่วไป/นามธรรม ผลงานของภาพยนตร์หรือโทรทัศน์

ตัวอย่างเช่น titleEIDR สําหรับซีซันแรกของ TVSeries ชื่อ "Game of Thrones" คือ "10.5240/FD91-C72C-4161-FCBA-058B-1"
seasonNumber จำนวนเต็ม ต้องระบุ - ตัวเลขที่ระบุตําแหน่งของซีซันนี้ตามลําดับของซีซันในซีรีส์
partOfSeries ทีวีซีรีส์ จําเป็น - ซีรีส์ของซีซันนี้
partOfSeries.@type Text จําเป็น - ตั้งค่าเป็น TVSeries เสมอ
partOfSeries.@id URL ต้องระบุ - @id ของ TVSeries ที่มีซีซันนี้
partOfSeries.name Text ต้องระบุ - ชื่อของซีรีส์
partOfSeries.sameAs Text URL ไปยังหน้าเว็บอ้างอิงที่สามารถระบุรายการได้ ตัวอย่างเช่น หน้า Wikipedia ของรายการ ต้องแตกต่างจากพร็อพเพอร์ตี้ url
potentialAction การดำเนินการเพื่อรับชม ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหาพร้อมใช้งานในวิดีโอออนดีมานด์ (VoD) คุณต้องระบุพร็อพเพอร์ตี้นี้ ออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุลิงก์ในรายละเอียดของเนื้อหา
  • หากเนื้อหาพร้อมใช้งานในช่อง 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 [บุคคล หรือ PerformingGroup หรือ PerformanceRole แนะนําอย่างยิ่ง เพราะเหตุใด อาร์เรย์ของสมาชิกนักแสดงในซีซัน ดูคําแนะนําการประมาณโมเดลที่นี่
director Person แนะนําอย่างยิ่ง เพราะเหตุใด อาร์เรย์ของผู้กํากับการแสดง
producer Organization หรือ Person แนะนําอย่างยิ่ง เพราะเหตุใด ผู้ผลิตซีซัน
image ImageObject รูปภาพที่เกี่ยวข้องกับ TVSeason โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่จําเป็นและที่ไม่บังคับเพื่อรวมไว้ใน image ที่พร็อพเพอร์ตี้รูปภาพ
genre Text รายการตามลําดับของประเภทที่เกี่ยวข้องทั้งหมด ตัวอย่างเช่น : ["Action", "Fashion", "Environment", "Football"]
keywords Text คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ยังมีอาร์เรย์ของคีย์เวิร์ดด้วย ตัวอย่างเช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
trailer.description Text คําอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง
trailer.inLanguage Text ภาษาของตัวอย่างในรูปแบบ BCP 47
trailer.url URL URL ของตัวอย่างที่โฮสต์แบบสาธารณะซึ่งอัปโหลดโดยสตูดิโอการผลิตหรือแหล่งที่มาที่ได้รับอนุญาตที่เกี่ยวข้อง
trailer.regionsAllowed สถานที่ ภูมิภาคที่อนุญาตสื่อ หากไม่ระบุ ระบบจะถือว่าเนื้อหาได้รับการอนุญาตในทุกที่ ระบุประเทศในรูปแบบ ISO 3166
identifier PropertyValue แนะนําอย่างยิ่ง เพราะเหตุใด - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ โปรดดูรายละเอียดในส่วนคุณสมบัติตัวระบุ
popularityScore ข้อกําหนดเฉพาะของความนิยม แนะนําอย่างยิ่ง เพราะเหตุใด คะแนนที่ 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 Text หรือ Organization ต้องระบุหาก 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 หรือ Performance roles หลายคน

การใช้ประเภท 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 ควรเหมือนกันในวัตถุของนักแสดงทั้ง 2 คนนี้

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

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

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

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@type บทบาทหน้าที่ ต้องระบุ - ตั้งค่าเป็น PerformanceRole เสมอ
roleName Text แนะนําอย่างยิ่ง เพราะเหตุใด - บทบาทที่เล่น ดําเนินการ หรือได้รับการเติมเต็มโดยสมาชิกนักแสดง โปรดดูรายการค่าที่ยอมรับได้ที่นี่
characterName Text ชื่อตัวละครที่เล่นในบทบาทบางอย่างหรือบางบทบาท อย่าตั้งค่าช่องนี้หากประเภทนักแสดงคือ PerformingGroup
actor Person หรือ PerformingGroup จําเป็น -
  • สมาชิกในทีมนักแสดงของเนื้อหาเมื่อใช้ประเภทข้อมูล Person
  • กลุ่ม/วงที่มีประสิทธิภาพของเนื้อหาเมื่อใช้ประเภทข้อมูล 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 ควรเหมือนกันในวัตถุของนักแสดงทั้ง 2 คนนี้

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

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

ค่าเหล่านี้กําหนดให้ actor.@type ต้องเป็น Person

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

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

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

การแยกความแตกต่างระหว่างบทบาทหลักและบทบาทสนับสนุนของผู้ดําเนินการ

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

ไม่รู้จักบทบาทของผู้ดําเนินการ

เมื่อไม่ทราบบทบาทนักแสดง เราขอแนะนําให้ระบุเฉพาะข้อมูลนักแสดงโดยใช้ประเภท บุคคล หรือ 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"
    }
  ]

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

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

"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"
      }
  }
]

บทบาทที่รู้จักสําหรับส่วนย่อยของผู้ดําเนินการ

เมื่อไม่ทราบข้อมูลเมตาของบทบาทด้านประสิทธิภาพ ขอแนะนําให้คุณระบุข้อมูลนักแสดงโดยใช้ประเภท บุคคล หรือ 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"
  }
]

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