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

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

BroadcastEvent 规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 将 xx 替换为实体的语言代码，采用 BCP 47 格式，例如“en”。
@type 文本 必需 - 始终设置为 BroadcastEvent。
@id 网址 必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。
@id 必须满足以下要求：
  • 在整个目录中全局唯一
  • 静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。
  • 采用统一资源标识符 (URI) 格式
  • 用于 @id 值的网域必须归贵组织所有。
由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @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。事件实体必须存在于 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 布尔值 如果适用，则为必需属性 - 如果没有为相应时段安排播出的内容，请使用此属性。
强烈建议 BroadcastEvent 实体包含以下至少一项：
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced 设置为 true
  • offAir 设置为 true
isLiveBroadcast 布尔值 如果这是直播活动（例如体育赛事或音乐会），请将此属性设为 true。
potentialAction WatchAction 如果适用，则为必需属性 - 如果内容以不含频道的直播活动的形式进行广播（将 contentToBeAnnounced 设为 false 或将 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 Text 或 Rating 对于成人内容，此属性为必需属性；对于其他内容，强烈建议提供- 直播内容的整体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：
  • 分级机构，位于分级前面，中间有空格。例如，美国机构“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: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"
        }
      ]
    }
  }
}

示例：在创建 Feed 时，如果不知道电视网络 Example TV (BroadcastService) 将于 2019 年 10 月 12 日晚上 9 点至 9:30 点播出的内容，则可以使用 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"
        }
      ]
    }
  }
}

如需了解与这些媒体资源相关的主题，请参阅以下页面：