本頁面由 Cloud Translation API 翻譯而成。

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

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

BroadcastEvent 規格表格

屬性	預期類型	說明
`@context`	文字	必要 - 一律設為 `["http://schema.org", {"@language": "xx"}]` 將 `xx` 替換為實體的語言代碼，格式為 BCP 47 格式，例如「en」。
`@type`	文字	必要 - 一律設為 `BroadcastEvent`。
`@id`	網址	必要 - 內容 ID，以 URI 格式表示；例如 https://example.com/1234abc。 `@id` 必須符合下列規定：產品目錄全球不重複靜態；這個 ID 應固定，不會隨時間而改變 (即使節目的網址資源有所變更)，系統會視為不透明字串，且不一定要是有效連結。採用統一資源識別碼 (URI) 格式用於 @id 值的網域必須由貴機構所擁有。由於實體的 `url` 符合 ID 的所有規定，因此我們建議您使用實體的 `url` 做為 `@id`。詳情請參閱「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`	Text 或 Country	如果 BroadcastEvent 用於 SportsEvent (即包含 `broadcastOfEvent` 屬性)，則為必要屬性 - 可以播送基礎 SportsEvent 的國家/地區。如果多個國家/地區可以播送 SportsEvent，則這個欄位可以是國家/地區清單。
`videoFormat`	文字	這項廣播服務支援的最高畫質；例如：「SD 標準畫質」「標準內容」規則「HD」。「2,000」2K 解析度「4K」4K 解析度「8,000」7K 解析度
`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` 實體類型只接受 `TMS_ID` 或 `TMS_ROOT_ID` 的 `propertyID` 值。只有在所有格式完整的頂層 `Movie`、`TVSeries`、`TVEpisode` 或 `SportsEvent` 實體未使用 `workPerformed` 或 `broadcastOfEvent` 屬性參照時，才需要提供這項屬性。屬性值應反映您理想情況下使用 `workPerformed` 或 `broadcastOfEvent` 屬性參照的 `Movie`、`TVSeries`、`TVEpisode` 或 `SportsEvent` 實體的 `TMS_ID` 或 `TMS_ROOT_ID`。建議使用 `TMS_ID`，而非 `TMS_ROOT_ID` 值。
`contentRating`	Text 或 Rating	如果內容含有成人內容，此為必填屬性，極力建議採用；原因- 廣播內容的整體內容分級。如果內容分級以文字字串的形式表示，可接受兩種變化版本：評分機構在評分前面加上空格，例如「PG-13」「MPAA」代理商的評分應稱之為「MPAA PG-13」。詳情請參閱代理商名單。「評分不認識」的值(不區分大小寫)，表示您不知道電影的分級。
`contentRating.author`	機構組織	如果 `contentRating` 使用 `Rating`，則為必填 - 評分機構的名稱。
`contentRating.ratingValue`	文字	如果 `contentRating` 使用 `Rating`，則為必要屬性 - 評分值。
`contentRating.advisoryCode`	文字	內容的指導程式碼。接受的值包括 D、FV、L、S 和 V. D = 對話、FV = 奇幻暴力、L = 語言、S = 色情內容、V = 暴力內容。

範例

某部電視電視台正在《Example TV》上播放 (BroadcastService)，介於 2019 年 10 月 12 日下午 9 點到 9 點 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 屬性在電視聯播網上放送 Example TV (BroadcastService) - 2019 年 10 月 12 日下午 9 點到 9 點 30 分之間建立動態饋給時：

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 段期間播出 1 節目「My favorite show」中午 12 點：

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

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

BroadcastEvent 規格表格

範例

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

相關網頁