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

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

ตารางข้อมูลจำเพาะของ BroadcastEvent

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบ BCP 47 เช่น "en"
@type Text ต้องระบุ - ตั้งค่าเป็น BroadcastEvent เสมอ
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อก
  • แบบคงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ URL ของรายการจะเปลี่ยนแปลงก็ตาม) ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
name Text ต้องระบุ - ชื่อรายการหรือกิจกรรม
description Text คำอธิบายรายการหรือกิจกรรม จำนวนอักขระสูงสุด 300 ตัว ใช้อาร์เรย์เพื่อใส่คำอธิบายหลายภาษาและหลายความยาว
startDate วันที่ ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
endDate วันที่ เวลาสิ้นสุดของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
publishedOn BroadcastService ต้องระบุหากมี - ระบุเอนทิตี BroadcastService ที่ออกอากาศรายการหรือกิจกรรมนี้

หากเนื้อหาออกอากาศในช่องทีวี คุณต้องใช้พร็อพเพอร์ตี้นี้ หากเนื้อหาไม่ได้เชื่อมโยงกับช่องทีวีใดๆ ก็ไม่ต้องระบุพร็อพเพอร์ตี้นี้
publishedOn.@type Text ตั้งค่าเป็น BroadcastService
publishedOn.@id URL @id ของเอนทิตี้ BroadcastService ที่ออกอากาศรายการหรือกิจกรรมนี้
workPerformed CreativeWork ต้องระบุหากมี - ใช้พร็อพเพอร์ตี้นี้เมื่อเนื้อหาเป็นเอนทิตีประเภทใดประเภทหนึ่งต่อไปนี้ Movie, TVSeries และ TVEpisode
เราขอแนะนำอย่างยิ่งว่าเอนทิตี BroadcastEvent ควรมีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
workPerformed.@type Text ตั้งค่าเป็น Movie, TVSeries หรือ TVEpisode
workPerformed.@id URL @id ของเอนทิตีโน้เนื้อหา
broadcastOfEvent SportsEvent ต้องระบุหากมี - ใช้พร็อพเพอร์ตี้นี้หากเนื้อหาเป็นกิจกรรมสด
  • สำหรับการแข่งขันกีฬา พร็อพเพอร์ตี้นี้ต้องอ้างอิงถึงเอนทิตี SportsEvent

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

ตั้งค่าเป็น true เมื่อผู้ให้บริการไม่มีข้อมูลล่าสุดเกี่ยวกับสิ่งที่จะออกอากาศ หรือตั้งค่าเป็น false หากมีข้อมูล
ขอแนะนำอย่างยิ่งว่าเอนทิตี BroadcastEvent ควรระบุข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
offAir บูลีน ต้องระบุหากมี - ใช้พร็อพเพอร์ตี้นี้หากไม่มีเนื้อหาที่วางแผนไว้ออกอากาศในช่วงเวลาดังกล่าว
เราขอแนะนำอย่างยิ่งว่าเอนทิตี BroadcastEvent ควรมีข้อมูลต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
isLiveBroadcast บูลีน ตั้งค่าเป็น true หากเป็นกิจกรรมถ่ายทอดสด เช่น การแข่งขันกีฬาหรือคอนเสิร์ต
potentialAction การดำเนินการเพื่อรับชม ต้องระบุหากมี - หากเนื้อหาออกอากาศเป็นกิจกรรมสตรีมมิงแบบสดที่ไม่มีช่อง (โดยตั้งค่า contentToBeAnnounced เป็น false หรือตั้งค่า offAir เป็น false) ให้ใช้พร็อพเพอร์ตี้นี้เพื่อระบุ Deep Link ของกิจกรรม
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 Text หรือ Rating ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และแนะนำอย่างยิ่งให้ระบุหากไม่ใช่เนื้อหาสำหรับผู้ใหญ่ เหตุผล - การจัดประเภทเนื้อหาโดยรวมของเนื้อหาที่ออกอากาศ หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับรูปแบบ 2 รูปแบบต่อไปนี้
  • โดยหน่วยงานจัดประเภทจะใส่ไว้ข้างหน้าคะแนนโดยมีเว้นวรรคคั่นไว้ เช่น การจัดประเภท "PG-13" จากหน่วยงาน "MPAA" ในสหรัฐอเมริกาควรอธิบายเป็น "MPAA PG-13" ดูรายชื่อเอเจนซี
  • ค่า "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 = ความรุนแรง

ตัวอย่าง

ตอนของรายการทีวีออกอากาศทางเครือข่ายโทรทัศน์ 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": "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 น. และออกอากาศรายการชื่อ My favorite show 1 รายการระหว่างเวลา 20:00-12:00 น.

BroadcastEvent 

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "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"
        }
      ]
    }
  }
}

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