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

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

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

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบรูปแบบ BCP 47 เช่น "en"
@type Text ต้องระบุ - ตั้งค่าเป็น BroadcastEvent เสมอ
@id URL ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่เหมือนใครทั่วโลกในแคตตาล็อกของคุณ
  • คงที่; รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ 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 ที่เกี่ยวข้อง ช่องนี้อาจเป็นรายชื่อประเทศหากมีหลายประเทศที่สามารถออกอากาศ SportsEvent ได้
videoFormat Text คุณภาพสูงสุดที่รองรับในบริการออกอากาศนี้ ตัวอย่างเช่น
  • "SD" สำหรับความละเอียดมาตรฐาน
  • "HD" ภาพความละเอียดสูง
  • "2 พัน" สำหรับความละเอียด 2K
  • "4K" สำหรับความละเอียด 4K
  • "8 พัน" สำหรับความละเอียด 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 ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ หากไม่แนะนำอย่างยิ่งให้ใช้ เพราะเหตุใด - การให้คะแนนเนื้อหาโดยรวมของเนื้อหาที่ออกอากาศ หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 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 น. และออกอากาศ 1 รายการชื่อ My favorite show ระหว่างเวลา 8 pm และ 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"
        }
      ]
    }
  }
}

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