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

ส่วนนี้จะให้รายละเอียดเกี่ยวกับพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี BroadcastEvent หากต้องการทำความเข้าใจความสัมพันธ์ระหว่างประเภทเหล่านี้ให้ดียิ่งขึ้น โปรดอ่านแนวคิดเกี่ยวกับเหตุการณ์ LiveTV

ตารางข้อกำหนด BroadcastEvent

พร็อพเพอร์ตี้ ประเภทที่คาดไว้ คำอธิบาย
@context ข้อความ ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบ BCP 47 เช่น "en"
@type ข้อความ ต้องระบุ - ตั้งค่าเป็น BroadcastEvent เสมอ
@id URL ต้องระบุ - ตัวระบุของช่วงเวลาออกอากาศในรูปแบบ URI เช่น https://example.com/live/channel1/20191012T2100
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกและแตกต่างจาก workPerformed.@id หรือ broadcastOfEvent.@id (เช่น รวมช่อง/บริการและเวลาเริ่มต้นการออกอากาศไว้ใน URI)
  • คงที่ รหัสควรคงที่และไม่เปลี่ยนแปลงเมื่อเวลาผ่านไป ระบบจะถือว่าค่านี้เป็นสตริงทึบแสงและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @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
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
workPerformed.@type ข้อความ ตั้งค่าเป็น Movie, TVSeries หรือ TVEpisode
workPerformed.@id URL @id ของเอนทิตีเนื้อหา
broadcastOfEvent SportsEvent ต้องระบุ หากมี - ใช้พร็อพเพอร์ตี้นี้หากเนื้อหาเป็นงานกิจกรรม
  • สำหรับการแข่งขันกีฬา พร็อพเพอร์ตี้นี้ต้องอ้างอิงถึงเอนทิตี SportsEvent

เราขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
broadcastOfEvent.@type ข้อความ ตั้งค่าเป็น SportsEvent
broadcastOfEvent.@id URL @id ของเอนทิตีเหตุการณ์ เอนทิตีเหตุการณ์ต้องอยู่ในฟีดและมี @id ที่แตกต่างจาก BroadcastEvent
location ข้อความหรือประเทศ ต้องระบุหาก BroadcastEvent มีไว้สำหรับ SportsEvent ซึ่งก็คือมีพร็อพเพอร์ตี้ broadcastOfEvent - ประเทศที่สามารถออกอากาศ SportsEvent ที่เกี่ยวข้องได้ ช่องนี้อาจเป็นรายชื่อประเทศหากมีหลายประเทศที่ออกอากาศ SportsEvent ได้
videoFormat ข้อความ ความละเอียดคุณภาพสูงสุดที่รองรับในบริการออกอากาศนี้ เช่น
  • "SD" สำหรับความละเอียดมาตรฐาน
  • "HD" สำหรับความละเอียดสูง
  • "2K" สำหรับความละเอียดระดับ 2K
  • "4K" สำหรับความละเอียดระดับ 4K
  • "8K" สำหรับความละเอียดระดับ 8K
contentToBeAnnounced บูลีน ต้องระบุ หากมี - ใช้พร็อพเพอร์ตี้นี้หากไม่ทราบเนื้อหาในขณะที่สร้างฟีด

ตั้งค่าเป็น true เมื่อผู้ให้บริการไม่มีข้อมูลล่าสุดเกี่ยวกับสิ่งที่จะออกอากาศ และตั้งค่าเป็น false ในกรณีอื่นๆ
ขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
offAir บูลีน ต้องระบุ หากมี - ตั้งค่าเป็น true เมื่อไม่มีการออกอากาศเนื้อหาที่วางแผนไว้สำหรับช่วงเวลาในช่อง BroadcastService
  • ตั้งค่าทั้ง name และ description เป็น "Off Air"
  • offAir BroadcastEvent แต่ละรายการต้องมีระยะเวลาไม่เกิน 4 ชั่วโมง (อย่าปล่อยบล็อกต่อเนื่อง 24 ชั่วโมง) เมื่อช่องหยุดออกอากาศนานกว่า 4 ชั่วโมง ให้ส่งเอนทิตี BroadcastEvent ที่ต่อเนื่องกันและไม่ทับซ้อนกันหลายรายการ โดยแต่ละรายการมีความยาวไม่เกิน 4 ชั่วโมง เพื่อให้ช่องมีผังรายการครอบคลุมตลอด 24 ชั่วโมงทุกวันโดยไม่มีช่องว่างที่จุดเริ่มต้นหรือจุดสิ้นสุดของกรอบเวลาฟีด
เราขอแนะนำอย่างยิ่งให้เอนทิตี BroadcastEvent มีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
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 รหัสภายนอกที่ระบุเนื้อหาการออกอากาศ ดูรายละเอียดได้ที่ส่วนพร็อพเพอร์ตี้ตัวระบุ
  • หมายเหตุ: ประเภทเอนทิตี BroadcastEvent ยอมรับค่า propertyID เป็น TMS_ID หรือ TMS_ROOT_ID เท่านั้น
  • คุณควรระบุพร็อพเพอร์ตี้นี้ก็ต่อเมื่อไม่มีการอ้างอิงเอนทิตี Movie, TVSeries, TVEpisode หรือ SportsEvent ระดับบนสุดที่สมบูรณ์โดยใช้พร็อพเพอร์ตี้ workPerformed หรือ broadcastOfEvent
  • ค่าของพร็อพเพอร์ตี้ควรแสดง TMS_ID หรือ TMS_ROOT_ID ของเอนทิตี Movie, TVSeries, TVEpisode หรือ SportsEvent ที่คุณควรจะอ้างอิงโดยใช้พร็อพเพอร์ตี้ workPerformed หรือ broadcastOfEvent
  • TMS_ID เหมาะกว่าค่า TMS_ROOT_ID
contentRating ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และขอแนะนำอย่างยิ่งสำหรับเนื้อหาอื่นๆ ทำไม - การจัดประเภทเนื้อหาโดยรวมของเนื้อหาที่ออกอากาศ หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 2 รูปแบบต่อไปนี้
  • หน่วยงานจัดประเภทที่เพิ่มไว้หน้าการจัดประเภทโดยมีเว้นวรรคคั่นกลาง เช่น การจัดประเภท "PG-13" จากหน่วยงาน "MPAA" ในสหรัฐอเมริกาควรอธิบายเป็น "MPAA PG-13" ดูรายชื่อเอเจนซี
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทของภาพยนตร์
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"
        }
      ]
    }
  }
}

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