ส่วนนี้จะให้รายละเอียดเกี่ยวกับพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี BroadcastEvent หากต้องการทำความเข้าใจความสัมพันธ์ระหว่างประเภทเหล่านี้ให้ดียิ่งขึ้น โปรดอ่านแนวคิดเกี่ยวกับเหตุการณ์ LiveTV
ตารางข้อกำหนด BroadcastEvent
| พร็อพเพอร์ตี้ | ประเภทที่คาดไว้ | คำอธิบาย |
|---|---|---|
@context |
ข้อความ | ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
|
@type |
ข้อความ | ต้องระบุ - ตั้งค่าเป็น BroadcastEvent เสมอ |
@id |
URL | ต้องระบุ - ตัวระบุของช่วงเวลาออกอากาศในรูปแบบ URI เช่น https://example.com/live/channel1/20191012T2100@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
url ใน BroadcastEvent หรือ SportsEvent ระบุ url Canonical ในเอนทิตีเนื้อหาที่เกี่ยวข้องเท่านั้น (Movie, TVSeries หรือ TVEpisode) ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ |
name |
ข้อความ | ต้องระบุ - ชื่อรายการหรือกิจกรรม |
description |
ข้อความ | คำอธิบายรายการหรือกิจกรรม จำกัดอักขระสูงสุด 300 ตัว ใช้อาร์เรย์เพื่อรวมคำอธิบายในหลายภาษา (1 รายการต่อภาษา) |
startDate |
วันที่ | ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา |
endDate |
วันที่ | เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา |
publishedOn |
BroadcastService | ต้องระบุ (หากมี) - ระบุเอนทิตี BroadcastService ที่ออกอากาศรายการหรือกิจกรรมนี้หากเนื้อหาออกอากาศทางช่องทีวี คุณต้องระบุพร็อพเพอร์ตี้นี้ หากเนื้อหาไม่ได้เชื่อมโยงกับช่องทีวีใดๆ โปรดอย่าระบุพร็อพเพอร์ตี้นี้ |
publishedOn.@type |
ข้อความ | ตั้งค่าเป็น BroadcastService |
publishedOn.@id |
URL | @id ของเอนทิตี BroadcastService ที่ออกอากาศรายการหรือกิจกรรมนี้ |
workPerformed |
CreativeWork | ต้องระบุ หากเกี่ยวข้อง - ใช้พร็อพเพอร์ตี้นี้เมื่อเนื้อหาเป็นเอนทิตีประเภทใดประเภทหนึ่งต่อไปนี้ Movie, TVSeries และ TVEpisodeเราขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีพร็อพเพอร์ตี้ต่อไปนี้อย่างน้อย 1 รายการ
|
workPerformed.@type |
ข้อความ | ตั้งค่าเป็น Movie, TVSeries หรือ TVEpisode |
workPerformed.@id |
URL | @id ของเอนทิตีเนื้อหา |
broadcastOfEvent |
SportsEvent | ต้องระบุ หากมี - ใช้พร็อพเพอร์ตี้นี้หากเนื้อหาเป็นงานกิจกรรม
เราขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
|
broadcastOfEvent.@type |
ข้อความ | ตั้งค่าเป็น SportsEvent |
broadcastOfEvent.@id |
URL | @id ของเอนทิตีเหตุการณ์ เอนทิตีเหตุการณ์ต้องอยู่ในฟีดและมี @id ที่แตกต่างจาก BroadcastEvent |
location |
ข้อความหรือประเทศ | ต้องระบุหาก BroadcastEvent มีไว้สำหรับ SportsEvent ซึ่งก็คือมีพร็อพเพอร์ตี้ broadcastOfEvent - ประเทศที่สามารถออกอากาศ SportsEvent ที่เกี่ยวข้องได้ ช่องนี้อาจเป็นรายชื่อประเทศหากมีหลายประเทศที่ออกอากาศ SportsEvent ได้ |
videoFormat |
ข้อความ | ความละเอียดคุณภาพสูงสุดที่รองรับในบริการออกอากาศนี้ เช่น
|
contentToBeAnnounced |
บูลีน | ต้องระบุ หากมี - ใช้พร็อพเพอร์ตี้นี้หากไม่ทราบเนื้อหาในขณะที่สร้างฟีด ตั้งค่าเป็น true เมื่อผู้ให้บริการไม่มีข้อมูลล่าสุดเกี่ยวกับสิ่งที่จะออกอากาศ และตั้งค่าเป็น false ในกรณีอื่นๆขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
|
offAir |
บูลีน | ต้องระบุ หากมี - ตั้งค่าเป็น true เมื่อไม่มีการออกอากาศเนื้อหาที่วางแผนไว้สำหรับช่วงเวลาในช่อง BroadcastService
BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
|
isLiveBroadcast |
บูลีน | ตั้งค่าเป็นบูลีน true (ไม่มีเครื่องหมายคำพูด) หากการออกอากาศนี้เป็นการถ่ายทอดสด (เช่น การแข่งขันกีฬาแบบสดหรือข่าวประจำวันแบบสด) หรือ false สำหรับรายการที่ไม่ใช่การถ่ายทอดสดและการเล่นซ้ำ |
potentialAction |
การดำเนินการเพื่อรับชม | ต้องระบุหากเกี่ยวข้อง - อย่าระบุ potentialAction ใน BroadcastEvent เมื่อ broadcastOfEvent อ้างอิงถึง SportsEvent (วาง Deep Link ของกีฬาทั้งหมดใน SportsEvent.potentialAction) หรือเมื่อ publishedOn อ้างอิงถึงช่อง BroadcastService (วาง Deep Link ของช่องใน BroadcastService.potentialAction) ระบุ BroadcastEvent.potentialAction สำหรับไลฟ์สดที่ไม่มีช่องซึ่งไม่ได้อ้างอิงถึง SportsEvent เท่านั้น (เช่น เนื้อหาเสริมแบบไลฟ์สดสแตนด์อโลนที่ละเว้น contentToBeAnnounced และ offAir หรือ false) |
identifier |
PropertyValue | รหัสภายนอกที่ระบุเนื้อหาการออกอากาศ ดูรายละเอียดได้ที่ส่วนพร็อพเพอร์ตี้ตัวระบุ
|
contentRating |
ข้อความหรือการจัดประเภท | ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และขอแนะนำอย่างยิ่งสำหรับเนื้อหาอื่นๆ ทำไม - การจัดประเภทเนื้อหาโดยรวมของเนื้อหาที่ออกอากาศ หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 2 รูปแบบต่อไปนี้
|
contentRating.author |
องค์กร | ต้องระบุหาก contentRating ใช้ Rating - ชื่อของหน่วยงานจัดประเภท |
contentRating.ratingValue |
ข้อความ | ต้องระบุหาก contentRating ใช้ Rating - ค่าของคะแนน |
contentRating.advisoryCode |
ข้อความ | รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับ ได้แก่ D, FV, L, S และ V โดย D = บทสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ, V = ความรุนแรง |
ตัวอย่าง
ตอนของรายการทีวีที่ออกอากาศทางเครือข่ายโทรทัศน์ Example TV (BroadcastService) ระหว่างเวลา 21:00 น. ถึง 21:30 น. ของวันที่ 12 ตุลาคม 2019
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
"name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
"description": "Three mice leave the town and the trip turns into something more.",
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"workPerformed": {
"@type": "TVEpisode",
"@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
}
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
ตัวอย่างที่แสดงการใช้พร็อพเพอร์ตี้ contentToBeAnnounced เมื่อไม่ทราบเนื้อหาที่จะออกอากาศในเครือข่ายโทรทัศน์ Example TV (BroadcastService) ระหว่างเวลา 21:00 น. ถึง 21:30 น. ของวันที่ 12 ตุลาคม 2019 ณ เวลาที่สร้างฟีด
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId",
"name": "Content To Be Announced",
"description": "Content To Be Announced",
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"contentToBeAnnounced": true
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
ช่อง Example TV (BroadcastService) ของเครือข่ายโทรทัศน์ไม่ได้ออกอากาศระหว่างเวลา 12:00 น. ถึง 20:00 น. (จำลองเป็นบล็อก Off Air ที่ต่อเนื่องกัน 2 บล็อก บล็อกละ 4 ชั่วโมง) และออกอากาศรายการชื่อ My favorite show ระหว่างเวลา 20:00 น. ถึง 00:00 น. ดังนี้
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId1",
"name": "Off Air",
"description": "Off Air",
"startDate": "2019-10-12T12:00-08:00",
"endDate": "2019-10-12T16:00-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"offAir": true
},
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId2",
"name": "Off Air",
"description": "Off Air",
"startDate": "2019-10-12T16:00-08:00",
"endDate": "2019-10-12T20:00-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"offAir": true
},
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId3",
"name": "My favorite show",
"description": "Evening broadcast of My favorite show.",
"startDate": "2019-10-12T20:00-08:00",
"endDate": "2019-10-13T00:00-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"workPerformed": {
"@type": "TVSeries",
"@id": "http://example.com/tv_series/my_favorite_show"
},
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
}
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
หน้าที่เกี่ยวข้อง
ดูหน้าต่อไปนี้สำหรับหัวข้อที่เกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้