直播電視活動的內容標記屬性

本節將詳細說明 BroadcastEvent 實體類型的內容標記屬性。如要進一步瞭解這些類型之間的關係,請參閱「LiveTV 事件」概念。

BroadcastEvent 規格表

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換為實體的 BCP 47 格式語言代碼,例如「en」。
@type 文字 必要:一律設為 BroadcastEvent。
@id 網址 必填:廣播時段的 ID,格式為 URI,例如 https://example.com/live/channel1/20191012T2100。
@id 必須符合下列規定:
  • 在目錄中全域不重複,且與 workPerformed.@id 或 broadcastOfEvent.@id 不同 (例如將頻道/服務和播送開始時間納入 URI)
  • 靜態:ID 應固定,不會隨著時間而改變。系統會將這個值視為不透明字串,且不一定要是有效連結。
  • 格式為統一資源識別碼 (URI)
  • 用於 @id 值的網域必須由貴機構所擁有。
重要事項:請勿在 BroadcastEvent 或 SportsEvent 中加入 url 屬性。請只在基礎內容實體 (Movie、TVSeries 或 TVEpisode) 上提供標準 url。詳情請參閱「ID」一節。
name 文字 必填:節目或活動的名稱。
description 文字 節目或活動的說明。最多 300 個字元限制。使用陣列加入多種語言的說明 (每種語言一則)。
startDate 日期 必填:活動開始時間,採用 ISO 8601 格式,並包含時區。
endDate 日期 活動的結束時間,採用 ISO 8601 格式,並包含時區。
publishedOn BroadcastService 視情況而定:請指定播送這個節目或活動的 BroadcastService 實體。

如果內容是在電視頻道上播送,則必須提供這項屬性。如果內容與任何電視頻道無關,請勿提供這項屬性。
publishedOn.@type 文字 請設為 BroadcastService。
publishedOn.@id 網址 播送這項節目或活動的 BroadcastService 實體 @id。
workPerformed CreativeWork 視情況而定:如果內容屬於下列任一實體類型,請使用這項屬性:Movie、TVSeries 和 TVEpisode。
強烈建議 BroadcastEvent 實體至少包含下列其中一項:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
workPerformed.@type 文字 設為 Movie、TVSeries 或 TVEpisode。
workPerformed.@id 網址 內容實體的 @id。
broadcastOfEvent SportsEvent 視情況而定:如果內容是現場活動,請使用這項屬性:
  • 如果是運動賽事,這項屬性必須參照 SportsEvent 實體。

強烈建議 BroadcastEvent 實體至少包含下列其中一項:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
broadcastOfEvent.@type 文字 請設為 SportsEvent。
broadcastOfEvent.@id 網址 事件實體的 @id。活動實體必須存在於動態饋給中,且 @id 與 BroadcastEvent 不同。
location 文字或國家/地區 如果 BroadcastEvent 適用於 SportsEvent,也就是具有 broadcastOfEvent 屬性,則為必填:基礎 SportsEvent 可播出的國家/地區。如果有多個國家/地區可以播送 SportsEvent,這個欄位可以是國家/地區清單。
videoFormat 文字 這項廣播服務支援的最高畫質定義,例如
  • 「SD」代表標準畫質。
  • 「HD」代表高畫質。
  • 「2K」代表 2K 解析度。
  • 「4K」代表 4K 解析度。
  • 「8K」代表 8K 解析度。
contentToBeAnnounced 布林值 視情況而定:如果建立動態饋給時不清楚內容,請使用這項屬性。

如果供應商沒有最新的廣播資訊,請設為 true,否則請設為 false。
強烈建議 BroadcastEvent 實體至少包含下列其中一項:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
offAir 布林值 視情況而定:如果 BroadcastService 頻道在特定時段沒有預定播出的內容,請設為 true。
  • 將 name 和 description 都設為 "Off Air"。
  • 每個 offAir BroadcastEvent 必須不超過 4 小時 (請勿發出 24 小時連續區塊)。如果頻道停播超過 4 小時,請發出多個連續且不重疊的 BroadcastEvent 實體,每個實體最多 4 小時,這樣頻道就能維持完整的 24 小時全年無休時間表,在動態消息視窗的開頭或結尾不會出現空檔。
強烈建議 BroadcastEvent 實體至少包含下列其中一項:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
isLiveBroadcast 布林值 如果播出內容是現場直播 (例如體育賽事或每日新聞直播),請設為布林值 true (不加引號);如果是非現場直播節目和重播,請設為 false。
potentialAction WatchAction 視情況而定:如果 broadcastOfEvent 參照 SportsEvent (請將所有體育賽事深層連結放在 SportsEvent.potentialAction),或 publishedOn 參照 BroadcastService 頻道 (請將頻道深層連結放在 BroadcastService.potentialAction),請勿在 BroadcastEvent 上提供 potentialAction。只有在無頻道直播未參照 SportsEvent 時,才提供 BroadcastEvent.potentialAction (例如省略 contentToBeAnnounced 和 offAir 或 false 的獨立直播額外內容)。
identifier PropertyValue 用於識別播送內容的外部 ID。詳情請參閱「ID 屬性」一節。
  • 注意:BroadcastEvent 實體類型只接受 TMS_ID 或 TMS_ROOT_ID 的 propertyID 值。
  • 只有在未透過 workPerformed 或 broadcastOfEvent 屬性參照完整頂層 Movie、TVSeries、TVEpisode 或 SportsEvent 實體時,才應提供這個屬性。
  • 屬性值應反映 Movie、TVSeries、TVEpisode 或 SportsEvent 實體的 TMS_ID 或 TMS_ROOT_ID,理想情況下,您應使用 workPerformed 或 broadcastOfEvent 屬性參照這些實體。
  • TMS_ID 的優先順序高於 TMS_ROOT_ID 值。
contentRating 文字或評分 成人內容必須提供,其他內容則強烈建議提供原因- 廣播內容的整體內容分級。如果內容分級是以文字字串形式提供,則可接受以下兩種變化版本:
  • 評等機構名稱會加在評等前面,中間以空格分隔。舉例來說,美國「MPAA」機構的「PG-13」分級應描述為「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 = 暴力。

範例

某個電視節目在 2019 年 10 月 12 日晚上 9 點到 9 點 30 分之間,於電視聯播網「Example TV」(BroadcastService) 播出:

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"
        }
      ]
    }
  }
}

以下範例說明在建立動態饋給時,如果不知道 2019 年 10 月 12 日晚上 9 點到 9 點 30 分之間,電視聯播網 Example TV (BroadcastService) 要播出的內容,該如何使用 contentToBeAnnounced 屬性:

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 點到晚上 8 點之間停播 (模擬為兩個連續 4 小時的 Off Air 區塊),並在晚上 8 點到凌晨 12 點之間播出一檔名為 My favorite show 的節目:

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"
        }
      ]
    }
  }
}

如要瞭解與這些屬性相關的主題,請參閱下列頁面: