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

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

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

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`。詳情請參閱「識別碼」一節。
`name`	Text	必要：節目或活動的名稱。
`description`	Text	節目或活動的說明。字數上限為 300 個半形字元。使用陣列加入多種語言和長度的說明。
`startDate`	日期	必要：活動的開始時間，採用 ISO 8601 格式，並附上時區。
`endDate`	日期	活動的結束時間，採用 ISO 8601 格式和時區。
`publishedOn`	BroadcastService	如適用，則為必要屬性：指定播出這部節目或活動的 `BroadcastService` 實體。如果內容是透過電視頻道播出，則必須使用這個屬性。如果內容未與任何電視頻道建立關聯，請不要提供這個屬性。
`publishedOn.@type`	Text	請設為 `BroadcastService`。
`publishedOn.@id`	網址	播放這部節目或活動的 `BroadcastService` 實體的 `@id`。
`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` 實體類型只接受 `TMS_ID` 或 `TMS_ROOT_ID` 的 `propertyID` 值。只有在未使用 `workPerformed` 或 `broadcastOfEvent` 屬性參照完整的頂層 `Movie`、`TVSeries`、`TVEpisode` 或 `SportsEvent` 實體時，才應提供這個屬性。屬性的值應反映您理想中使用 `workPerformed` 或 `broadcastOfEvent` 屬性參照的 `Movie`、`TVSeries`、`TVEpisode` 或 `SportsEvent` 實體的 `TMS_ID` 或 `TMS_ROOT_ID`。 `TMS_ID` 優先於 `TMS_ROOT_ID` 值。
`contentRating`	文字或評分	成人內容必須使用，其他內容強烈建議使用原因- 廣播內容的整體內容分級。如果內容分級是以文字字串的形式提供，系統會接受兩種變化形式：評級機構會在評級前加上空格，舉例來說，美國「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"
        }
      ]
    }
  }
}

範例：在建立動態時，如果不知道 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": "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 點之間播出 1 個名為 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"
        }
      ]
    }
  }
}

直播電視活動的內容標記屬性 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

BroadcastEvent 規格表

範例

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

相關網頁

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