Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

直播电视活动的内容标记属性

本部分详细介绍了 BroadcastEvent 实体类型的内容标记属性。如需更好地了解这些类型之间的关系，请查看 LiveTV 活动概念。

BroadcastEvent 规范表

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 将 `xx` 替换为实体的语言代码（采用 BCP 47 格式），例如“en”。
`@type`	文本	必需 - 始终设置为 `BroadcastEvent`。
`@id`	网址	必需 - 采用 URI 格式的广播时段标识符；例如 https://example.com/live/channel1/20191012T2100。 `@id` 必须满足以下要求：在整个目录中全局唯一，且不同于 `workPerformed.@id` 或 `broadcastOfEvent.@id`（例如，将频道/服务和直播开始时间纳入 URI）静态；该 ID 应保持稳定，不应随着时间的推移而发生变化。它将被视为不透明字符串，且不必是有效链接。采用统一资源标识符 (URI) 的形式用于 `@id` 值的网域必须归您的组织所有。重要提示：请勿在 `BroadcastEvent` 或 `SportsEvent` 中添加 `url` 属性。仅在底层内容实体（`Movie`、`TVSeries` 或 `TVEpisode`）上提供规范 `url`。如需了解详情，请参阅标识符部分。
`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`。活动实体必须存在于 Feed 中，并且其 `@id` 与 `BroadcastEvent` 的不同。
`location`	文本或国家/地区	如果 BroadcastEvent 针对的是 SportsEvent（即具有 `broadcastOfEvent` 属性），则此属性为必需属性 - 基础 SportsEvent 可在其中播出的国家/地区。如果多个国家/地区可以直播该 SportsEvent，则此字段可以是国家/地区列表。
`videoFormat`	文本	此广播服务支持的最高画质；例如 “SD”表示标清。 “HD”表示高清晰度。 “2K”表示 2K 分辨率。 “4K”表示 4K 分辨率。 “8K”表示 8K 分辨率。
`contentToBeAnnounced`	布尔值	必需（如果适用） - 如果在创建 Feed 时内容未知，请使用此属性。如果提供方没有关于将要播出的内容的最新信息，请设置为 `true`，否则设置为 `false`。强烈建议 `BroadcastEvent` 实体至少包含以下一项： `workPerformed` `broadcastOfEvent` `contentToBeAnnounced` 设置为 `true` `offAir` 设置为 `true`
`offAir`	布尔值	必需（如果适用）- 如果 `BroadcastService` 频道在相应时间段内没有计划播出的内容，请设置为 `true`。将 `name` 和 `description` 设置为 `"Off Air"`。每个 `offAir` `BroadcastEvent` 必须跨越 4 小时或更短时间（请勿发出 24 小时连续块）。当频道停播超过 4 小时，请发出多个连续、不重叠的 `BroadcastEvent` 实体，每个实体最多 4 小时，以便频道保持完整的 24x7 全天候时间表覆盖，在 Feed 窗口的开始或结束时没有间隙。强烈建议 `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。如需了解详情，请参阅标识符属性部分。注意：`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`	文本	如果 `contentRating` 使用 `Rating`，则此属性为必需属性 - 评分的值。
`contentRating.advisoryCode`	文本	内容的警示代码。可接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 奇幻暴力、L = 语言、S = 色情内容、V = 暴力。

示例

2019 年 10 月 12 日晚上 9 点到 9 点半，电视网络 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"
        }
      ]
    }
  }
}

以下示例展示了在创建 Feed 时，如果不知道 2019 年 10 月 12 日晚上 9 点到 9 点半之间要在电视网络 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"
        }
      ]
    }
  }
}

直播电视活动的内容标记属性 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

BroadcastEvent 规范表

示例

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

相关页面

直播电视活动的内容标记属性