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

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

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

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

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

เช่น titleEIDR สำหรับซีรีส์ทีวีซีซันแรกที่รู้จักกันในชื่อ "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 คีย์เวิร์ดหรือแท็กที่ใช้เพื่ออธิบายเนื้อหานี้ นอกจากนี้ยังอนุญาตให้ใช้กลุ่มคีย์เวิร์ดด้วย เช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดที่ใช้อธิบายเนื้อหา
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 เพื่อระบุรายละเอียดของกลุ่ม/วงดนตรีเมื่อไม่ทราบบทบาทที่นักแสดงรับ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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