此页面由 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`	文本	此广播服务支持的最高质量定义；例如， “标清”。 “HD”。 “2K”。 “4K”。 “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`	文字或评分	必须为成人内容提供，否则强烈建议提供。为什么？- 对广播内容的总体内容分级。如果内容分级以文本字符串的形式指定，可以接受以下两种形式：分级机构在评分前面附加了一个空格。例如，“PG-13”评级由代理机构“MPAA”应称为“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 = 暴力。

示例

某电视剧集通过电视网络播放 Example TV (BroadcastService) 2019 年 10 月 12 日晚上 9 点到 9:30 之间：

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 属性的示例通过电视网广播 Example TV (BroadcastService) 2019 年 10 月 12 日晚上 9 点到 9:30 之间是未知的在创建 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"
        }
      ]
    }
  }
}

电视网 Example TV（BroadcastService）频道已停播中午 12 点到晚上 8 点，8 点播出 1 个名为“My favorite show”的节目下午 1 点至 12 点：

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

相关页面