此页面由 Cloud Translation API 翻译。

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

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

BroadcastEvent 规范表

媒体资源	预期类型	说明
`@context`	Text	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 将 `xx` 替换为采用 BCP 47 格式的实体语言代码，例如“en”。
`@type`	Text	必需 - 始终设置为 `BroadcastEvent`。
`@id`	网址	必需 - 采用 URI 格式的内容标识符，例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在目录中具有全局唯一性静态：ID 应保持稳定，不会随时间发生变化（即使节目的网址属性发生变化也是如此）。它被视为不透明字符串，且不必是有效链接。采用统一资源标识符 (URI) 形式 @id 值使用的域名必须归您的组织所有。由于实体的 `url` 满足作为标识符的所有要求，因此我们建议您将实体的 `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`。事件实体必须存在于 Feed 中，并且具有不同于 `BroadcastEvent` 的 `@id`。
`location`	Text 或 Country	如果 BroadcastEvent 用于 SportsEvent，即具有 `broadcastOfEvent` 属性，则为必需属性 - 可以直播底层 SportsEvent 的国家/地区。如果多个国家/地区都可以播放 SportsEvent，则此字段可以是国家/地区列表。
`videoFormat`	Text	此广播服务支持的最高画质定义；例如， “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` 实体时，才应提供此属性。该属性的值应反映 `Movie`、`TVSeries`、`TVEpisode` 或 `SportsEvent` 实体的 `TMS_ID` 或 `TMS_ROOT_ID`（理想情况下，您需要使用 `workPerformed` 或 `broadcastOfEvent` 属性引用该实体）。 `TMS_ID` 优先于 `TMS_ROOT_ID` 值。
`contentRating`	文字或评分	必须为成人内容提供此属性，其他属性为强烈推荐。为什么？- 广播内容的总体内容分级。如果内容分级是以文本字符串的形式提供的，则系统接受两种变体：分级机构在分级前加上一个空格。例如，美国代理机构“MPAA”给出的“PG-13”分级应描述为“MPAA PG-13”。请参阅代理机构列表。 “RATING NOT KNOWN”值（不区分大小写），表明您不知道电影的分级。
`contentRating.author`	Text 或 Organization	如果 `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"
        }
      ]
    }
  }
}

使用 contentToBeAnnounced 属性的示例：2019 年 10 月 12 日晚上 9 点至晚上 9:30 之间在电视网络示例电视 (BroadcastService) 上广播的内容在创建 Feed 时未知：

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

电视网络示例(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

相关页面