电台的内容标记属性

本部分详细介绍了 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 格式。如需了解详情和示例，请参阅城市、州、国家/地区、AdministrativeArea 部分。
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”是 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 规范中，broadcaster 和 broadcastAffiliateOf 属性均使用 Organization 类型。

属性 预期类型 说明
@type Text 必需属性：请始终将此属性设置为 Organization。
@id URL 必需：组织的全局唯一 ID，采用 URI 格式。该 ID 必须保持稳定，不应随着时间的推移而发生变化。它被视为不透明字符串，且不必是有效链接。
name Text 必需：组织的名称。
sameAs URL 此属性是指向明确标识组织的参考网页的网址。例如，组织的维基百科网页或组织的官方网站。

以下是 Organization 示例：

SINGLE 

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

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

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

STATE 

"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 存在关联，因为它会播放 GPR 和 GPI 制作的部分内容。
  • GQEI 由 GQED Inc 和 GPCB 共同所有。它是 GQED 的转播/转译站，服务于不同的区域。GQEI 还隶属于 GPR 和 GPI。
  • G-music 是一家国际电台，由 GRJ 所有，隶属于 G-music 电台网络（一个与该电台同名的不同实体）。G-music 电台遍布全国各地，播放由 G-music 电台网络制作的部分内容。

如需详细了解与本页所述属性相关的主题，请参阅以下页面：