本部分详细介绍了 RadioBroadcastService
实体类型的内容标记属性。如需了解完整详情,请参阅完整的 Feed 示例。
规范表
属性 | 预期类型 | 说明 |
---|---|---|
@context |
Text |
必需:始终将此属性设为 ["http://schema.googleapis.com", {"@language": "xx"}] ,其中 xx 表示 Feed 中字符串的语言。每个根实体上下文都必须将其 @language 设置为适当的语言代码,并且采用 BCP 47 格式。例如,如果语言设置为西班牙语,则即使字幕或配音语言为英语,系统也会假定名称为西班牙语。 |
@type |
Text |
必需:始终将此属性设为 RadioBroadcastService 。 |
@id |
URL |
必需 - 内容的标识符(采用 URI 格式),例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足作为标识符的所有要求,因此我们建议您将该实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
URL |
必需:内容的规范网址,用于提供电台的相关信息。url 属性必须满足以下要求:
|
name |
Text |
必需:电台的官方名称。每种语言只能有一个官方名称。例如“WXKS FM”。使用数组列出不同语言的名称。如需查看示例,请参阅多个区域和多种语言。 |
alternateName |
Text |
帮助用户识别该电台的备用名称。此属性必须是电台的合法备用名称,而不是能够影响触发条件的关键字。对于关键字,请改用 keywords 属性。使用数组列出不同语言的名称。如需查看示例,请参阅多个区域和多种语言。 |
callSign |
Text |
如果适用:必须填写:政府官方签发的电台呼号。例如“KQEI-FM”。对于北美电台,此属性为必需属性。对于没有使用呼号的地区,这是可选功能。 |
broadcastDisplayName |
Text |
必需:电台的显示名称或品牌信息。例如,“虚假电台 105”。除了值(例如呼号和名称)等其他关键信息外,这些值还有助于用户在查询中识别此电台。 |
description |
Text |
必需:对电台的简要说明。此属性不得超过 300 个字符。使用数组标记多种语言的说明。如需查看示例,请参阅多个区域和多种语言。 |
slogan |
Text |
电台的口号。例如,“Google 排名第一的虚构音乐电台”。 |
logo |
ImageObject |
电台的徽标图片。提供尽可能高的分辨率。格式必须为 JPEG 或 PNG。如需了解详情和示例,请参阅 ImageObject 部分。 |
broadcastFrequency |
BroadcastFrequencySpecification |
必需:电台的频率规范。对于地面 AM/FM 电台,此属性为必需属性。对于仅在线播放的视频流,该值必须设置为 INTERNET_STREAM 字符串。如需了解详情和示例,请参阅 BroadcastFrequencySpecification 部分。 |
areaServed |
City, State, Country, or AdministrativeArea |
必需:电台定位的主要地理区域。使用此属性可从关联且名称相似的电台网络中选择最合适的电台。例如,使用它来选择与地方关联公司建立全国性广播服务。建议的格式为 city, (optional) state, country。有关详情和示例,请参阅城市、州/省级行政区、国家/地区、行政区域部分。 |
broadcastAffiliateOf |
Organization |
必需(如果适用):电台所属的联属频道,或提供在电台上播放内容的联属频道。例如“NPR”、“PRI”或“PBS”。如果电台不属于任何联属关系,则此属性并非必要属性。有关详情和示例,请参阅组织部分。 |
broadcaster |
Organization |
必需:拥有、运营和运营电台的组织。有关详情和示例,请参阅组织部分。 |
parentService |
RadioBroadcastService |
如果适用(如果适用):仅当电台是中继器或翻译器时才需要此属性。它代表中继器或译者中继的原始电台。如需了解详情和示例,请参阅 RadioBroadcastService 部分。 |
potentialAction |
ListenAction |
必需:用户为了收听电台而触发的 Action。如需了解详情,请参阅 ListenAction 部分。 |
popularityScore |
PopularityScoreSpecification |
强烈建议原因Google 根据得分和其他信号来确定要为用户播放的媒体。此分数代表的是内容相对于您目录中的其他内容的受欢迎程度。因此,您的各个 Feed 及目录中所有实体的得分必须一致。默认情况下,实体的受欢迎程度得分设置为 0 。 |
inLanguage |
Text |
在电台中播放的内容所使用的语言。该值必须是采用 BCP 47 格式的语言代码。此值可用于满足请求特定语言内容的用户查询。如果电台在不同的时间广播不同的语言,只需列出主要语言即可。 |
keywords |
Text |
与电台关联的关键字列表。使用这些关键字可扩展触发电台的用户查询。例如,“新闻”、“体育”或“摇滚”。 |
identifier |
PropertyValue |
强烈建议原因- 外部 ID 或明确标识此实体的另一个 ID。允许使用多个标识符。有关详情,请参阅标识符属性部分。 |
sameAs |
URL |
明确指明了商品身份的参考网页对应的网址。例如,广播服务的维基百科网页。 |
实体类型属性引用
以下是实体类型及其属性引用。
广播频率规范
BroadcastFrequencySpecification
实体类型与 broadcastfrequency
属性相关联。
BroadcastFrequencySpecification
实体类型用于按电台频率标识电台。对于数字电台,频率信道可能具有多个具有不同节目的子信道。在这些情况下,broadcastSubChannel
值用于定位频段内的目标电台。
对于仅支持互联网的电台,不需要使用 BroadcastFrequencySpecification
对象,因此请改用字符串值 INTERNET_STREAM
。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 BroadcastFrequencySpecification 。 |
broadcastFrequencyValue |
Text |
必需:频率的数字部分。例如“89.3.”。对于数字音频广播 (DAB) 电台,这必须是块编号。例如“12A”。 |
broadcastSignalModulation |
Text |
必需:频率的信号调制部分。该值必须是“FM”、“AM”、“HD”、“DAB”或“DAB+”。 |
broadcastSubChannel |
Text |
如果适用:必需;如果是数字电台,则为子频道。对于 DAB 和 DAB+ 电台,此值为服务 ID。例如,“HD1”-“HD8”是 HD 电台的可能值,而“C8D8”是 DAB 的可能值。 |
以下是 BroadcastFrequencySpecification
示例:
FM(高清)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
上午
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "1010",
"broadcastSignalModulation": "AM",
},
DAB
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "12B",
"broadcastSignalModulation": "DAB",
"broadcastSubChannel": "C8D8"
},
仅限互联网
"broadcastFrequency": "INTERNET_STREAM",
组织
Organization
实体类型与 broadcaster
或 broadcastAffiliateOf
属性相关联。
在 RadioBroadcastService
规范中,Organization
类型同时用于 broadcaster
和 broadcastAffiliateOf
属性。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 Organization 。 |
@id |
URL |
必需:采用 URI 格式的组织的全局唯一 ID。该 ID 必须保持稳定,不应随着时间的推移而发生变化。它被视为不透明字符串,且不必是有效链接。 |
name |
Text |
必需:组织的名称。 |
sameAs |
URL |
此属性是一个指向参考网页的网址,可明确识别相应组织。例如该组织的维基百科网页或单位的官方网站。 |
以下是 Organization
示例:
单曲
"broadcaster": {
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio",
"sameAs": "https://www.billyradio-example.org/",
"name": "Billy Radio Inc"
},
多所有者
"broadcaster": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio"
"name": "Billy Radio Inc"
"sameAs": "https://www.billyradio-example.org/"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/Gmusic"
"name": "Gmusic",
}
],
多网络
"broadcastAffiliateOf": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/npr",
"name": "NPR",
"sameAs": "https://en.wikipedia.org/wiki/NPR"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/pri",
"name": "PRI",
"sameAs": "https://www.pri.org/"
}
],
RadioBroadcastService
RadioBroadcastService
实体类型与 parentService
属性相关联。
parentService
属性用于中继器或翻译器工作站以指示其父级电台。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 RadioBroadcastService 。 |
@id |
URL |
必需:代表父级电台的网址格式,必须是全局唯一的。如果将父电台也作为独立的实体包含在 Feed 中,请确保这两个 ID 相同。 |
name |
Text |
必需:父级电台的名称。 |
sameAs |
URL |
用于明确标识父级站点的参考网页对应的网址。例如,父站的维基百科网页。 |
以下是一个 RadioBroadcastService
示例:
"parentService": {
"@type": "RadioBroadcastService",
"@id": "https://www.tjradio.org/stations?id=10",
"name": "GQED-FM",
"sameAs": "https://en.vikibedia.org/wiki/GQED-FM"
},
ImageObject
ImageObject
实体类型与 logo
属性相关联。
logo
属性用于为给定的电台提供徽标图片。这些图片会作为给定电台实体的深层链接显示在内容旁边。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 ImageObject 。 |
height |
Integer |
图片的高度(以像素为单位)。 |
width |
Integer |
此图片的宽度,以像素为单位。 |
contentUrl |
URL |
必需:可提取图片的网址。 |
regionsAllowed |
Country |
允许使用媒体的国家/地区。如果未指定此属性,则系统会假定图片可在所有语言区域显示。 若要为每个区域提交不同的图片,请添加多种 ImageObject 类型,每种类型都有自己的一组国家/地区及相应的图片网址。 |
国家/地区
Country
实体类型与 logo.regionsAllowed
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
始终将此属性设为 Country 。 |
name |
Text |
ISO 3166-1 alpha-2。例如,“GB”或“US”。 |
以下是ImageObject
示例:
通用徽标
"logo": {
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
徽标(按国家/地区)
"logo": [
{
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/12345.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "PK"
}
]
},
],
PropertyValue
PropertyValue
实体类型与 identifier
属性相关联。
如果您为内容使用第三方 ID 系统(例如 Gracenote ID (TMS)),则该 ID 可由 identifier
属性提供。这会提高 Google 对电台的对帐的准确性。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 PropertyValue 。 |
propertyID |
Text |
必需:指定 ID 的类型。我们支持以下 ID 类型:
|
value |
Text |
用于明确标识父级站点的参考网页对应的网址。例如,父站的维基百科网页。 |
以下是一个 PropertyValue
示例:
"identifier": {
"@type": "PropertyValue",
"propertyID": "WIKIDATA_ID",
"value": "Q795598"
},
热门程度得分规范
PopularityScoreSpecification
实体类型与 popularityScore
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 PopularityScoreSpecification 。 |
value |
Number |
必需:与目录中的其他实体相比的正数值。数字越大表示热门程度越高。 |
eligibleRegion |
Country |
热门程度得分适用的国家/地区或区域列表。如果热门程度得分在全球范围内适用,则只需使用 earth 作为文本值即可。如果需要列出特定区域,请使用 Country 类型。如果此属性未添加,则 eligibleRegion 默认为 earth 。 |
国家/地区
Country
实体类型与 popularityScore.eligibleRegion
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 Country 。 |
name |
Text |
必需:ISO 3166-1 alpha-2。例如,“GB”或“US”。 |
以下是 PopularityScoreSpecification
示例:
全球热门程度
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
针对特定国家/地区
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
城市、省/直辖市/自治区、国家/地区、行政区
City
、State
、Country
和 AdministrativeArea
实体类型与 areaServed
属性相关联。
areaServed
属性可以根据用户的位置信息帮助您选择最合适的电台。位置信息的示例包括用户查询,例如“我附近的电台”或“本地新闻电台”。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设置为以下实体类型之一:City 、State 、Country 或 AdministrativeArea 。 |
name |
Text |
必填:城市、州/省级行政区、国家/地区或区域的名称。提供最精细的区域。此外,请提供包含的链。请使用以下格式:city, state, country。 |
以下是 areaServed
示例:
城市
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
状态
"areaServed": [
{
"@type": "State",
"name": "California, US"
},
{
"@type": "State",
"name": "Nevada, US"
}
],
国家/地区
"areaServed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "Australia"
}
],
行政区
"areaServed": [
{
"@type": "AdministrativeArea",
"name": "Cape Cod, Massachusetts, US"
}
],
ListenAction
ListenAction
实体类型与 potentialAction
属性相关联。
ListenAction
属性定义要用于播放的深层链接。它还定义了用户访问相应内容的条件。例如 geo/chronal/login/subscription status
。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 ListenAction 。 |
target |
EntryPoint |
必需:深层链接的规范。其中包含支持的平台信息。可以使用多个 EntryPoint 实体类型来为不同的平台集定义不同的深层链接。 |
actionAccessibilityRequirement |
ActionAccessSpecification |
必需:定义访问此实体的用户要求。如果存在多个 ActionAccessSpecification 实体类型,则符合任何规范条件的用户将能够访问内容。 |
EntryPoint
EntryPoint
实体类型与 potentialAction.target
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 EntryPoint 。 |
urlTemplate |
Text |
必需:用于启动内容播放的链接。 |
actionPlatform |
Text |
必需:深层链接适用的平台。可能的值包括:
|
ActionAccessSpecification
ActionAccessSpecification
实体类型与 potentialAction.actionAccessibilityRequirement
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 ActionAccessSpecification 。 |
category |
Text |
必需:访问要求的类型。它必须是以下值之一:
|
availabilityStarts |
DateTime |
可用时段的开始时间。使用此属性可控制此内容何时可供用户观看。 |
availabilityEnds |
DateTime |
可用时段的结束时间。使用此属性可控制用户停止看到此内容的确切时间。 |
eligibleRegion |
Country |
可以使用Offer 的国家/地区。使用此属性可控制应提供或不应提供相应内容的国家/地区。 |
requiresSubscription |
MediaSubscription |
访问内容所需的订阅包。如果您的服务提供多个订阅套餐,则此属性是必需的。如果您的服务是免费的,或只有一项订阅服务,那么您可以跳过此属性。 |
国家/地区
Country
实体类型与 potentialAction.actionAccessibilityRequirement.eligibleRegion
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 Country 。 |
name |
Text |
必需:ISO 3166-1 alpha-2 国家/地区代码。 |
媒体订阅
MediaSubscription
实体类型与 potentialAction.actionAccessibilityRequirement.requiresSubscription
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 MediaSubscription 。 |
@id |
Text |
必需:订阅软件包的全局唯一 ID,采用 URI 格式。该 ID 必须保持稳定,不应随着时间的推移而发生变化。它被视为不透明字符串,且不必是有效链接。 |
name |
Text |
必需:订阅套餐的名称。例如“G-Radio 高级”或“A-Radio 基本版”。 |
expectsAcceptanceOf |
Offer |
与购买媒体订阅关联的 Offer 类型。此属性用于指明订阅价格。 |
优惠
Offer
实体类型与 potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf
属性相关联。
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Text |
必需:始终将此属性设为 Offer 。 |
price |
Number |
必需:订阅价格。 |
priceCurrency |
Text |
必需:价格所用币种,采用由三个字母表示的 ISO 4217 格式。 |
seller |
Organization |
提供订阅或购买操作的组织。使用与 Organization 部分中所述的架构相同的架构。 |
以下是 ListenAction
示例:
通用深层链接
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
平台特定
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.org/castlink?streamStationId=170",
"actionPlatform": [
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
}
],
"actionAccessibilityRequirement": [
{
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://www.example.com/packages/basic-pack",
"name": "G-Radio Basic Pack",
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 8.99,
"priceCurrency": "USD"
}
},
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
]
},
完整 Feed 示例
在这个完整的 Feed 示例中,我们提供了一个假设的无线装置数据提供程序 TJ_RADIO。TJ_RADIO 向我们提供了电台数据的收听操作,以及联属关系和所有权信息。 在此 Feed 中,显示了 3 个无线网络(向联属电台提供内容),展示了 GPR、GRI 和 G-music。 此外,还有 3 个电台:GQED、GQEI 和 G-music。
- GQED 归 GQED Inc 和 GPCB 所有,这两家公司属于两个不同的组织。此外,GQED 还与 GPR 相关联,因为它会广播一些由 GPR 和 GPI 创建的内容。
- GQEI 还归 GQED Inc 和 GPCB 所有。它是 GQED 的中继器/翻译器站,服务于不同的区域。GQEI 也是 GPR 和 GPI 的关联公司。
- G-music 是一个国际电台,归 GRJ 所有,并隶属于无线网络 G-music(与同名电台不同的实体)。G 音乐电台遍布全国各地,并播放一些由无线网络 G 音乐创作的内容。
相关页面
如需详细了解与本页所述属性相关的主题,请参阅以下页面: