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

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

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

พร็อพเพอร์ตี้ ประเภทที่คาดไว้ คำอธิบาย
@context ข้อความ จำเป็น - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
เสมอ
  • แทนที่ xx ด้วยรหัสภาษาของเอนทิตีในรูปแบบรูปแบบ BCP 47 เช่น "en"
@type ข้อความ จำเป็น - ตั้งค่าเป็น BroadcastEvent เสมอ
@id URL ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกของคุณ
  • คงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าคุณสมบัติ URL ของรายการจะเปลี่ยนแปลงไป) ระบบจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ทำงานได้
  • ในรูปแบบ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในการเป็นตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมในส่วนตัวระบุ
name ข้อความ ต้องระบุ - ชื่อรายการหรือกิจกรรม
description ข้อความ คำอธิบายรายการหรือกิจกรรม วรรณกรรม 300 อักขระ ใช้อาร์เรย์เพื่อรวมคำอธิบายในหลายภาษาและความยาว
startDate Date ต้องระบุ - เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601 พร้อมเขตเวลา
endDate Date เวลาสิ้นสุดของกิจกรรมในรูปแบบ 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 Text หรือ Country ต้องระบุหาก 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 บูลีน ต้องระบุ (หากมี) - ใช้พร็อพเพอร์ตี้นี้หากไม่มีการเผยแพร่เนื้อหาที่วางแผนไว้สำหรับช่วงเวลานั้นๆ
ขอแนะนำเป็นอย่างยิ่งให้เอนทิตี BroadcastEvent รวมสิ่งต่อไปนี้อย่างน้อย 1 รายการ
  • workPerformed
  • broadcastOfEvent
  • ตั้งค่าที่อยู่contentToBeAnnouncedเป็น true แล้ว
  • ตั้งค่าที่อยู่offAirเป็น true แล้ว
isLiveBroadcast บูลีน หากเป็นการถ่ายทอดสด เช่น การแข่งขันกีฬาหรือคอนเสิร์ต ให้ตั้งค่าเป็น true
potentialAction WatchAction ต้องระบุ (หากมี) - หากเนื้อหาออกอากาศเป็นกิจกรรมสตรีมมิงแบบสดที่น้อยลง (โดยตั้งค่า 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 Text หรือ Organization ต้องระบุหาก contentRating ใช้ Rating - ชื่อหน่วยงานการจัดประเภท
contentRating.ratingValue ข้อความ ต้องระบุหาก contentRating ใช้ Rating - ค่าของคะแนน
contentRating.advisoryCode ข้อความ รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับ ได้แก่ D, FV, L, S และ V D = การสนทนา, FV = ความรุนแรงแฟนตาซี , L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ, V = ความรุนแรง

ตัวอย่าง

ตอนรายการทีวีจะออกอากาศบนเครือข่ายโทรทัศน์ ตัวอย่างทีวี (BroadcastService) ในวันที่ 12 ตุลาคม 2019 ระหว่างเวลา 21:00 น. ถึง 21:30 น.

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 เมื่อเนื้อหาที่จะออกอากาศในเครือข่ายทีวี ตัวอย่างทีวี (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"
        }
      ]
    }
  }
}

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

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