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

本節提供 BroadcastEvent 實體類型的內容標記屬性詳細資料。如要進一步瞭解這些類型之間的關係，請參閱「LiveTV Events」概念。

BroadcastEvent 規格表

屬性 預期類型 說明
@context Text 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 將 xx 替換為實體的語言代碼，並採用 BCP 47 格式，例如「en」。
@type Text 必要 - 一律設為 BroadcastEvent。
@id 網址 必要 - 內容的 ID，格式為 URI，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 目錄中全域專屬
  • 靜態：這個 ID 應固定，不會隨著時間而改變 (即使節目網址屬性變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。
  • 格式為統一資源識別碼 (URI)
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
name Text 必要 - 節目或活動的名稱。
description Text 節目或活動的說明。長度上限為 300 個半形字元。使用陣列加入多種語言和長度的說明。
startDate 日期 必填 - 活動的開始時間，採用 ISO 8601 格式，並包含時區。
endDate 日期 活動的結束時間，採用 ISO 8601 格式，並附上時區。
publishedOn BroadcastService 如適用則為必填 - 指定播送節目或活動的 BroadcastService 實體。

如果內容是在電視頻道上播送，則必須提供這項屬性。如果內容未與任何電視頻道建立關聯，請勿提供這項屬性。
publishedOn.@type Text 請設為 BroadcastService。
publishedOn.@id 網址 播送這項節目或活動的 @id BroadcastService 實體。
workPerformed CreativeWork 適用時為必填 - 如果內容屬於下列實體類型，請使用這項屬性：Movie、TVSeries 和 TVEpisode。
強烈建議 BroadcastEvent 實體至少包含下列其中一項：
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
workPerformed.@type Text 設為 Movie、TVSeries 或 TVEpisode。
workPerformed.@id 網址 內容實體的 @id。
broadcastOfEvent SportsEvent 適用時為必填 - 如果內容為直播活動，請使用這個屬性：
  • 如果是體育賽事，這項屬性必須參照 SportsEvent 實體。

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

如果供應商沒有即將播出的最新資訊，請設為 true，否則請設為 false。
強烈建議 BroadcastEvent 實體至少包含下列其中一項：
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
offAir 布林值 適用時為必填 - 如果時段沒有預定播出的內容，請使用這項屬性。
強烈建議 BroadcastEvent 實體至少包含下列其中一項：
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced已設在true
  • offAir已設在true
isLiveBroadcast 布林值 如果是體育賽事或演唱會等直播活動，請設為 true。
potentialAction WatchAction 適用時為必填 - 如果內容是以頻道式直播活動的形式播送 (contentToBeAnnounced 設為 false 或 offAir 設為 false)，請使用這項屬性提供活動的深層連結。
identifier PropertyValue 識別廣播內容的外部 ID。詳情請參閱「ID 屬性」一節。
  • 注意：BroadcastEvent 實體類型只接受 propertyID 值，且值必須為 TMS_ID 或 TMS_ROOT_ID。
  • 只有在未使用 workPerformed 或 broadcastOfEvent 屬性參照完整頂層 Movie、TVSeries、TVEpisode 或 SportsEvent 實體時，才應提供這項屬性。
  • 屬性的值應反映您理想上會使用 workPerformed 或 broadcastOfEvent 屬性參照的 Movie、TVSeries、TVEpisode 或 SportsEvent 實體的 TMS_ID 或 TMS_ROOT_ID。
  • TMS_ID 比 TMS_ROOT_ID 值更合適。
contentRating Text 或 Rating 成人內容必須提供，其他內容則強烈建議提供為什麼？ - 廣播內容的整體內容分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體：
  • 評等機構名稱會加在評等前面，並以半形空格分隔。舉例來說，美國「MPAA」機構的「PG-13」分級應描述為「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 代表暴力。

範例

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

以下範例顯示如何使用 contentToBeAnnounced 屬性。假設在建立動態饋給時，您不知道 2019 年 10 月 12 日晚上 9 點到 9 點 30 分，電視網「Example TV」(BroadcastService) 要播出的內容：

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 點到晚上 8 點之間停播，並在晚上 8 點到下午 12 點之間播映名為「My favorite show」的節目：

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

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