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

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

本節提供 BroadcastEvent 實體類型內容標記屬性的詳細資料。如要進一步瞭解這兩種類型之間的關係，請參閱「直播電視事件」概念。

BroadcastEvent 規格表格

屬性	預期類型	說明
`@context`	文字	必要 - 一律設為 `["http://schema.org", {"@language": "xx"}]` 將 `xx` 替換成採用 BCP 47 格式的實體語言代碼，例如「en」。
`@type`	文字	必要 - 一律設為 `BroadcastEvent`。
`@id`	網址	必要 - URI 格式的內容 ID，例如 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」代表高畫質。「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`	Text 或 Rating	這是成人內容的必填屬性，強烈建議提供原因- 廣播內容的整體內容分級。如果內容分級是以文字字串的形式表示，系統接受兩種變化版本：評分機構的前面會加上空白字元。舉例來說，在美國代理商「MPAA」的「PG-13」分級應標示為「MPAA PG-13」。請參閱代理商清單。這個值是「RATING NOT KNOWN」(不區分大小寫)，表示您不知道電影的分級。
`contentRating.author`	Text 或 Organization	如果 `contentRating` 使用 `Rating`，則為必填 - 分級機構的名稱。
`contentRating.ratingValue`	文字	如果 `contentRating` 使用 `Rating`，則為必要欄位 - 評分的值。
`contentRating.advisoryCode`	文字	內容的建議代碼。接受的值包括 D、FV、L、S 和 V。D = Dialogue、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 點之間播送名為 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

相關網頁