电台的内容标记属性

本部分详细介绍了 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 必需：为用户触发的 Action，以便他们收听电台。如需了解详情，请参阅 ListenAction 部分。
popularityScore PopularityScoreSpecification 强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相较于目录中的其他内容的热门程度。因此，您的 Feed 和目录中的所有实体必须使用一致的评分标准。默认情况下，实体的热门程度得分设为 0。
inLanguage Text 电台播放内容所使用的语言。该值必须是采用 BCP 47 格式的语言代码。使用此值可满足请求特定语言内容的用户查询。如果电台在不同时间以不同的语言播放节目，请仅列出主要语言。
keywords Text 与电台相关联的关键字列表。使用这些关键字可扩展触发相应电台的用户查询。例如“新闻”“体育”或“摇滚”。
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”是高清调频的可能值，“C8D8”是数字音频广播的可能值。

以下是 BroadcastFrequencySpecification 示例：

FM (HD) 

"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 必需：一个网址格式的全局唯一 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]），则 identifier 媒体资源可以提供该 ID。这有助于提高 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"
  }
},

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

City、State、Country 和 AdministrativeArea 实体类型与 areaServed 属性相关联。

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

属性 预期类型 说明
@type Text 必需：始终将此属性设置为以下实体类型之一：City、State、Country 或 AdministrativeArea。
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 会为我们提供与广播数据相关的收听操作，以及联属关系和所有权信息。 在此 Feed 中，显示了 3 个电台网络（向联属电台提供内容）：GPR、GRI 和 G-music。此外，还会显示 3 个电台：GQED、GQEI 和 G-music。

  • GQED 由 GQED Inc 和 GPCB 这两个不同的组织拥有。此外，由于 GQED 会播放 GPR 和 GPI 制作的部分内容，因此与 GPR 有关联。
  • GQEI 也归 GQED Inc 和 GPCB 所有。它是 GQED 的转发器/转换器台，服务于其他区域。GQEI 还与 GPR 和 GPI 相关联。
  • G-music 是一个国际电台，由 GRJ 拥有，并与电台网络 G-music（与电台同名但不同的实体）相关联。G-music 电台遍布全国各地，播放由电台网络 G-music 制作的部分内容。

如需详细了解与本页介绍的媒体资源相关的主题，请参阅以下页面：