本部分详细介绍了 BroadcastEvent
实体类型的内容标记属性。如需更好地了解这些类型之间的关系,请参阅 LiveTV 事件概念。
BroadcastEvent 规范表
媒体资源 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必需 - 始终设置为 BroadcastEvent 。 |
@id |
网址 | 必需 - 采用 URI 格式的内容标识符,例如 https://example.com/1234abc。@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.@type |
Text | 设置为 Movie 、TVSeries 或 TVEpisode 。 |
workPerformed.@id |
网址 | 内容实体的 @id 。 |
broadcastOfEvent |
SportsEvent | 必需属性(如果适用) - 如果内容是直播活动,请使用此属性:
强烈建议 BroadcastEvent 实体至少包含下列其中一项:
|
broadcastOfEvent.@type |
Text | 设置为 SportsEvent 。 |
broadcastOfEvent.@id |
网址 | 事件实体的 @id 。事件实体必须存在于 Feed 中,并且具有不同于 BroadcastEvent 的 @id 。 |
location |
Text 或 Country | 如果 BroadcastEvent 用于 SportsEvent,即具有 broadcastOfEvent 属性,则为必需属性 - 可以直播底层 SportsEvent 的国家/地区。如果多个国家/地区都可以播放 SportsEvent,则此字段可以是国家/地区列表。 |
videoFormat |
Text | 此广播服务支持的最高画质定义;例如,
|
contentToBeAnnounced |
布尔值 | 必需(若适用)- 如果在创建 Feed 时内容未知,请使用此属性。 如果提供商没有关于要播放的内容的最新信息,请设置为 true ,否则为 false 。强烈建议 BroadcastEvent 实体至少包含以下内容中的一项:
|
offAir |
布尔值 | 必需(如果适用)- 如果相应时段没有计划播放内容,请使用此属性。 强烈建议 BroadcastEvent 实体至少包含下列其中一项:
|
isLiveBroadcast |
布尔值 | 如果是直播活动(例如体育赛事或音乐会),则设为 true 。 |
potentialAction |
WatchAction | 必需(若适用)- 如果内容作为非频道的直播活动(将 contentToBeAnnounced 设为 false 或 offAir 设为 false )播出,请使用此属性提供活动的深层链接。 |
identifier |
PropertyValue | 用于标识广播内容的外部 ID。如需了解详情,请参阅标识符属性部分。
|
contentRating |
文字或评分 | 必须为成人内容提供此属性,其他属性为强烈推荐。为什么?- 广播内容的总体内容分级。如果内容分级是以文本字符串的形式提供的,则系统接受两种变体:
|
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"
}
]
}
}
}
相关页面
查看以下页面,了解与这些属性相关的主题: