此页面由 Cloud Translation API 翻译。

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

本部分详细介绍了 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"
        }
      ]
    }
  }
}

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

BroadcastEvent 规范表

示例

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

相关页面