电台的内容标记属性

本部分详细介绍了 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 必须满足以下要求:
  • 在您的目录中保持全局唯一
  • 静态;ID 应保持稳定,不应随着时间的推移而变化(即使节目的网址属性发生变化)。它将被视为不透明字符串,且不必是有效链接。
  • 采用统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归您的组织所有。
由于实体的 url 满足作为标识符的所有要求,我们建议您使用实体的 url 作为 @id。如需了解详情,请参阅标识符部分。
url URL 必需:内容的规范网址,用于提供电台的相关信息。

url 属性必须满足以下要求:
  • 它必须是全局唯一的。
  • 该网址必须包含可供 Google 抓取的有效规范网址。
  • 此网址必须指向未被付费墙屏蔽的内容说明页面。
name Text 必需:电台的官方名称。每种语言只能有一个官方名称。例如,“WXKS FM”。可以使用数组列出不同语言的名称。如需查看示例,请参阅多区域和多种语言
alternateName Text 方便用户识别电台的别名。此属性必须是电台的合法别名,而不是影响触发的关键字。对于关键字,请改用 keywords 属性。可以使用数组列出不同语言的名称。如需查看示例,请参阅多区域和多种语言
callSign Text 如果适用,则为必填:政府核发的电台官方呼号。例如:“KQEI-FM”。对于北美电台,此属性为必需属性。对于不常用呼号的地区,这是可选的。
broadcastDisplayName Text 必需:电台的显示名称或品牌信息。例如,“Fake Radio 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 必需:在用户收听电台时触发的操作。如需了解详情,请参阅 ListenAction 部分。
popularityScore PopularityScoreSpecification 强烈推荐为什么?Google 会根据此得分以及其他信号来确定要为用户播放哪些媒体。此得分表示该内容相对于目录中其他内容的热门程度。因此,您的 Feed 以及目录中的所有实体的得分范围必须保持一致。默认情况下,实体的热门程度得分设置为 0
inLanguage Text 在电台播放的内容的语言。该值必须是采用 BCP 47 格式的语言代码。使用此值可执行请求特定语言内容的用户查询。如果电台使用不同的语言广播,则只需列出主要语言即可。
keywords Text 与电台相关的关键字列表。使用这些关键字可扩充触发相应电台的用户查询。例如,“新闻”“sports”或“摇滚”。
identifier PropertyValue 强烈推荐为什么?- 外部 ID 或用于明确标识此实体的其他 ID。允许使用多个标识符。如需了解详情,请参阅标识符属性部分。
sameAs URL 明确指明了项目身份的参考网页对应的网址。例如,介绍广播服务的维基百科网页。

实体类型属性引用

以下是实体类型及其属性引用。

BroadcastFrequencySpecification

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 无线装置的可取值,是 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 实体类型与 broadcasterbroadcastAffiliateOf 属性。

RadioBroadcastService 规范中,使用 Organization 类型 同时适用于 broadcasterbroadcastAffiliateOf 属性。

属性 预期类型 说明
@type Text 必需:始终将此属性设置为 Organization
@id URL 必需:组织的全局唯一 ID,采用 URI 格式。该 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 必需:采用网址格式的全局唯一 ID,表示父级电台。如果父电台还作为单独的实体包含在您的 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 实体类型与 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 的类型。我们支持以下身份证件类型:
  • TMS_ROOT_ID:Gracenote ID (TMS) 根 ID。例如,"15829"。
  • TMS_ID:Gracenote ID (TMS) 变体 ID。例如,"MV000398520000"。
  • WIKIDATA_ID:WikiData ID。例如,“Q795598”。
value Text 指向明确标识父站的参考网页的 网址。例如,父站的维基百科网页。

下面是一个 PropertyValue 示例:

  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "WIKIDATA_ID",
    "value": "Q795598"
  },

PopularityScoreSpecification

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"
  }
},

城市、省/自治区/直辖市、国家/地区、行政区

CityStateCountryAdministrativeArea 实体类型 与 areaServed 属性相关联。

areaServed 属性可帮助您根据以下内容选择最合适的电台: 用户的位置信息。位置信息的示例包括 查询,如“我附近的电台”或“本地新闻电台”

属性 预期类型 说明
@type Text 必需:始终将此属性设置为以下实体类型之一:CityStateCountryAdministrativeArea
name Text 必需属性:国家/地区、城市、州/省/自治区/直辖市或区域的名称。提供最精细的区域。此外,请提供包含链。请使用以下格式:city, state, country

以下是 areaServed 示例:

CITY

"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"
  }
],

ADMINISTRATIVEAREA

"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 必需:深层链接适用的平台。可能的值包括:
  • 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

ActionAccessSpecification

ActionAccessSpecification 实体类型与 potentialAction.actionAccessibilityRequirement 属性。

属性 预期类型 说明
@type Text 必需:始终将此属性设置为 ActionAccessSpecification
category Text 必需:访问权限要求的类型。此项必须为以下值之一:
  • nologinrequired:用户无需购买或登录即可访问内容。
  • free:此操作不需要用户购买或付费订阅。该操作仍要求用户登录。
  • subscription:付费订阅您的服务即可获享这项操作。
availabilityStarts DateTime 可用时段的开始时间。使用此属性可控制向用户提供此内容的确切时间。
availabilityEnds DateTime 可用时段的结束时间。使用此属性可以控制不再向用户提供此内容的确切时间。
eligibleRegion Country 符合 Offer 条件的国家/地区。使用此属性可控制应提供或不应提供此内容的国家或地区。
requiresSubscription MediaSubscription 访问内容所需的订阅包。如果您的服务提供多种订阅套餐,则必须提供此属性。如果您的服务是免费的,或者只有单一层级的订阅服务,则可以跳过此资源。
国家/地区

Country 实体类型与 potentialAction.actionAccessibilityRequirement.eligibleRegion 属性。

属性 预期类型 说明
@type Text 必需:始终将此属性设置为 Country
name Text 必需:ISO 3166-1 alpha-2 国家/地区代码。
MediaSubscription

MediaSubscription 实体类型与 potentialAction.actionAccessibilityRequirement.requiresSubscription 属性。

属性 预期类型 说明
@type Text 必需:始终将此属性设置为 MediaSubscription
@id Text 必需:订阅套餐的全局唯一 ID,采用 URI 格式。该 ID 必须保持稳定,不应随着时间的推移而发生变化。它被视为不透明字符串,且不必是有效链接。
name Text 必需:订阅套餐的名称。例如,“G-Radio Premium”或“A-Radio Basic”
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 为我们提供对电台数据的收听操作,以及联属关系和所有权信息。 在该供稿中,有 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-music 电台遍布全国各地,还会播放 G-music 电台制作的部分内容。

如需详细了解与媒体资源相关的主题,请参阅以下页面 :