本部分详细介绍了 BroadcastService
、CableOrSatelliteService
、TelevisionChannel
和 Organization
实体类型的内容标记属性。如需更好地了解这些类型之间的关系,请查看 LiveTV 频道概念。
BroadcastService 规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必需 - 始终设置为 BroadcastService 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
网址 | 必需(如果适用) - 广播服务的规范网址,前提是频道可在互联网上观看。对于通过有线/卫星/无线下载方式提供的服务,此字段是可选的。Google 使用此网址将您的 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求:
urlTemplate 属性。 |
name |
Text | 必需 - 广告联盟的名称。
|
broadcastDisplayName |
Text | 必需 - 用户在节目指南中通常看到的网络的显示名称。此值可能与名称值相同。 |
callSign |
Text | 政府签发的广播服务呼号。 |
inLanguage |
Text 或 Language | 强烈建议原因频道的主要广播语言。请使用 IETF BCP 47 标准中的一种语言代码。 |
category |
Text | 强烈建议原因商品所属类别。大符号或斜杠可用于以非正式的方式指明某个类别的层次结构。例如,体育、体育 > 足球、新闻、电影、音乐、纪实。 |
contentRating |
文字或评分 | 仅限成人使用的电视广播服务 - 对频道内容广播的限制最为严格。如果内容分级是以文本字符串的形式提供的,则分级机构需要在其前面加上空白,二者之间应留有空白;例如,在美国,来自代理机构“TVPG”的分级为“TV-Y”,该分级称为“TVPG TV-Y”。请参阅代理机构列表。 |
contentRating.author |
文字或组织 | 如果 contentRating 使用 Rating ,则为必需项 - 分级机构的名称。 |
contentRating.ratingValue |
Text | 如果 contentRating 使用 Rating ,则为必需值 - 评分的值。 |
contentRating.advisoryCode |
Text | 内容的建议代码。接受的值包括 D、FV、L、S 和 V;D = 对话、FV = 幻想暴力内容、L = 语言、S = 色情内容、V = 暴力内容。 |
description |
Text | 广播服务的说明。字符数限制为 300 个。使用数组以多种语言和/或以不同长度提供说明。 |
slogan |
Text | 广播服务的口号。 |
areaServed |
Country、State、City 或 GeoShape | 如果适用(必填) - 如果频道开关由电视服务提供商执行,则必须提供。用户预计会在其中接收广播服务的区域。可以使用 ISO 3166-1 国家/地区代码指定国家/地区。 |
logo |
ImageObject | 必须与 Google TV 集成时才需要。强烈建议(否则)为什么?代表此广播服务的图片。
|
potentialAction |
WatchAction | 如果适用(必需)- 一个操作标记对象,用于提供操作的详细信息。如需了解详情,请参阅操作标记属性。
|
videoFormat |
Text | 此广播服务支持的最高质量定义;例如,
|
broadcastTimezone |
Text | 此广播服务的时区,采用 IANA 格式,例如 America/Los_Angeles。一个数组用于多个时区。 |
broadcastAffiliateOf |
组织 | 必需 - 提供此广播服务或此广播服务所属组织的节目的电视网络。 |
broadcastAffiliateOf.@id |
Text | 必需 - 设为电视网络的 @id 。 |
broadcastAffiliateOf.@type |
Text | 必需 - 始终设置为 Organization 。 |
identifier |
PropertyValue | 强烈建议原因- 用于标识此实体的外部 ID 或其他 ID,例如 _PARTNER_ID_。允许使用多个标识符。如需了解详情,请参阅标识符属性部分。 |
popularityScore |
热门程度得分规范 | 强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度;因此,该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下,实体的热门程度分数设为 0。 |
popularityScore.@type |
Text | 始终设置为 PopularityScoreSpecification 。 |
popularityScore.value |
编号 | 非负数值,表示实体的热门程度;分数越高,表示热门程度越高。 |
popularityScore.eligibleRegion |
国家/地区 | 此热门程度得分适用的地区。如果热门程度得分是全球适用的,则设为 EARTH 。默认情况下,此属性会设置为 EARTH 。Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度 |
BroadcastService 示例
{
"@context": [
"http://schema.org",
{
"@language": "en"
}
],
"@type": "BroadcastService",
"@id": "http://example.com/stations/example-tv",
"name": "EXAMPLE-TV",
"broadcastDisplayName": "ABCD",
"url": "http://example.com/stations/example-tv",
"callSign": "EXA-TV",
"videoFormat": "SD",
"inLanguage": "en",
"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"
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
},
"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",
"authenticator": {
"@type": "Organization",
"name": "TVE"
}
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"logo": [
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Light",
"contentUrl": "http://example.com/images/example-logo-light.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forLightBackground"
]
}
]
},
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Dark",
"contentUrl": "http://example.com/images/example-logo-dark.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground"
]
}
]
}
]
}
CableOrSatelliteService 规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必需 - 始终设置为 CableOrSatelliteService 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
name |
Text | 必需 - 电视服务的名称。
|
areaServed |
Country、State、City 或 GeoShape | 必需 - 用户预计会接收广播服务的领域。
|
provider |
组织 | 必需 - 服务的父级提供商(如果适用)。例如,ExampleTV 是其区域服务 ExampleTV San Francisco 和 ExampleTV San Diego 的提供商。 |
provider.@id |
Text | 必需 - 电视运营商的 ID。 |
provider.@type |
Text | 必需 - 始终设置为 Organization 。 |
identifier |
PropertyValue | 强烈建议原因- 用于标识此实体的外部 ID 或其他 ID,例如此广播服务的 Gracenote TMS ID。允许使用多个标识符。如需了解详情,请参阅标识符属性部分。 |
CableOrSatelliteService 示例
有线电视或卫星电视服务示例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/provider-lineups/exampletv-san-francisco",
"name":"ExampleTV San Francisco",
"provider": {
"@type": "Organization",
"@id": "http://example.com/providers/exampletv"
},
"areaServed":[
{
"@type":"GeoShape",
"@id": "http://example.com/area1"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
}
}
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
虚拟多频道视频节目分发商 (vMVPD) 示例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv",
"name":"My Online Example TV",
"provider": {
"@type": "Organization",
"@id": "http://my-online-tv.com"
},
"areaServed":[
{
"@type":"Country",
"name": "US",
},
{
"@type":"Country",
"name": "CA",
}
]
}
TelevisionChannel 规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必需 - 始终设置为 TelevisionChannel 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
broadcastChannelId |
Text | 必需 - 此 BroadcastService 可标识为有线、卫星或互联网电视服务的唯一标识符。
|
channelOrder |
编号 | 对于 GoogleTV 是必需的,否则为可选 - 使用此属性可指定频道在 Google TV 集成方案的电子收视指南中的显示顺序。channelOrder 在 Feed 中的各个渠道中应是独一无二的,理想情况下应从 1 开始。“channelOrder ”的值不能为负或 0。 |
broadcastServiceTier |
Text | 请使用以下值:
|
inBroadcastLineup |
有线电视卫星服务 | 必需 - 向观看者提供此频道的 CableOrSatelliteService 的 @id 。 |
providesBroadcastService |
BroadcastService | 必需 - 此频道提供的节目的 BroadcastService 的 @id 。 |
TelevisionChannel 示例
有线电视或卫星电视频道示例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/exampleTV/example-tv-7",
"broadcastChannelId":"7",
"channelOrder": 1,
"broadcastServiceTier":["Premium", "Standard"],
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/exampleTV-san-francisco"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/example-tv"
}
}
在线电视频道示例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/my-online-example-tv/sport-channel",
"broadcastChannelId":"sport-channel",
"channelOrder": 3,
"broadcastServiceTier":"Premium",
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/sport-channel"
}
}
组织规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必需 - 始终设置为 Organization 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
name |
Text | 必需 - 电视网络、电视内容提供方或电视运营商的名称。
|
description |
Text | 对组织的说明。字符数限制为 300 个。使用数组以多种语言和/或以不同长度提供说明。 |
sameAs |
网址 | 强烈建议原因指向维基百科页面(可识别电视网络)的网址。此网址必须与网址属性不同。仅使用介绍单个频道/网络实体的维基百科页面。请注意,维基百科页面可以使用术语“频道”。 |
potentialAction |
WatchAction | 如果适用(必须提供) - 如果您有多个频道 (BroadcastService) 引用该组织,则必须提供。一个操作标记对象,用于提供操作的详细信息。如需了解详情,请参阅操作标记属性。
|
url |
网址 | 组织的网址。Google 使用此网址与 Google 数据库中的组织准确核对。 |
identifier |
PropertyValue | 强烈建议原因- 用于标识此实体的外部 ID 或其他 ID,例如此组织的 TMS ID。允许使用多个标识符。如需了解详情,请参阅标识符属性部分。 |
popularityScore |
热门程度得分规范 | 强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度;因此,该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下,实体的热门程度分数设为 0。 |
popularityScore.@type |
Text | 始终设置为 PopularityScoreSpecification 。 |
popularityScore.value |
编号 | 非负数值,表示实体的热门程度;分数越高,表示热门程度越高。 |
popularityScore.eligibleRegion |
国家/地区 | 此热门程度得分适用的地区。如果热门程度得分是全球适用的,则设为 EARTH 。默认情况下,此属性会设置为 EARTH 。Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度 |
组织示例
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network",
"name":"ABCD",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-12345"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/networkstream",
"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": "2050-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
相关页面
请查看以下页面,了解与这些属性相关的主题: