This section provides the details of the content markup properties for the
RadioBroadcastService
entity type. For complete details, see the
Full feed example.
Specification table
Property | Expected type | Description |
---|---|---|
@context |
Text |
Required: Always set this property to ["http://schema.googleapis.com", {"@language": "xx"}] , where xx represents the language of the strings in the feed.Each root entity context must have its @language set to the appropriate language code, and in BCP 47 format. For example, if the language is set to Spanish, the names are assumed to be in Spanish even if the subtitle or dub language is in English. |
@type |
Text |
Required: Always set this property to RadioBroadcastService . |
@id |
URL |
Required - The content's identifier in URI format; for example, https://example.com/1234abc.@id must meet the following requirements:
url meets all the requirements as an identifier, we recommend you use an entity's url as @id . See the Identifier section for more details. |
url |
URL |
Required: The content's Canonical URL, which supplies information about the radio station. The url property must meet the following requirements:
|
name |
Text |
Required: The official name of the radio station. There must be only one official name per language. For example, "WXKS FM." Use an array to list the names in different languages. For an example, see Multiple regions and languages. |
alternateName |
Text |
Alternate names that help users identify the radio station. This property must be legitimate alternate names for a station, not keywords to influence triggering. For keywords, use the keywords property instead. Use an array to list the names in different languages. For an example, see Multiple regions and languages. |
callSign |
Text |
Required if applicable: The official government-issued callsign of the radio station. For example, "KQEI-FM." For North American radio stations, this property is required. For regions where callsigns aren't commonly used, this is optional. |
broadcastDisplayName |
Text |
Required: The display names or brandings of the radio station. For example, "Fake Radio 105." The values help users identify this radio station in their queries, in addition to other key information such as callsign and name. |
description |
Text |
Required: A brief description of the radio station. This property has a 300-character limit. Use an array to mark up the description in multiple languages. For an example, see Multiple regions and languages. |
slogan |
Text |
Slogan of the radio station. For example, "Google’s number one fictional music radio station." |
logo |
ImageObject |
A logo image of the station. Provide the highest resolution available. The format must be either JPEG or PNG. For details and examples, see the ImageObject section. |
broadcastFrequency |
BroadcastFrequencySpecification |
Required: The frequency specification of the radio station. For terrestrial AM/FM radio stations, this property is required. For online-only streams, the value must be set to the INTERNET_STREAM string. For details and examples, see the BroadcastFrequencySpecification section. |
areaServed |
City, State, Country, or AdministrativeArea |
Required: The primary geographic area targeted by the radio station. Use this property to select the most appropriate station among a network of affiliated, similarly named stations. For example, use it to select a nationally broadcast radio service with local affiliates. The suggested format is city, (optional) state, country. For details and examples, see the City, State, Country, AdministrativeArea section. |
broadcastAffiliateOf |
Organization |
Required if applicable: The affiliate that the radio station is a member of, or the affiliate that provides the content that's broadcast on the radio station. For example, "NPR," "PRI," or "PBS." If the radio station isn't part of any affiliation, this property isn't required. For details and examples, see the Organization section. |
broadcaster |
Organization |
Required: The organization who owns, runs, and operates the radio station. For details and examples, see the Organization section. |
parentService |
RadioBroadcastService |
Required if applicable: This property is only required when the radio station is a repeater or translator. It represents the original radio station that the repeater or translator relays. For details and examples, see the RadioBroadcastService section. |
potentialAction |
ListenAction |
Required: The Action that's triggered for users in order to listen to the radio station. For details, see the ListenAction section. |
popularityScore |
PopularityScoreSpecification |
Highly Recommended Why? A score that Google uses, plus other signals, to determine which media to play for users. This score represents the popularity of the content in relation to other content in your catalog. Therefore, the score's scale must be consistent across your feeds, and all the entities in your catalog. By default, an entity's popularity score is set to 0 . |
inLanguage |
Text |
The language of the content that's broadcast on the radio station. The value must be a language code in BCP 47 format. Use this value to fulfill user queries that request contents in a specific language. If the station broadcasts in different languages at different times, just list the primary language. |
keywords |
Text |
A list of keywords associated with the radio station. Use these keywords to expand the user queries that trigger the radio station. For example, "news," "sports," or "rock." |
identifier |
PropertyValue |
Highly Recommended Why? - The external ID or another ID that unambiguously identifies this entity. Multiple identifiers are allowed. For details, see the Identifier properties section. |
sameAs |
URL |
The URL of a reference web page that unambiguously indicates the item's identity. For example, a Wikipedia page for the broadcast service. |
Entity-type property references
The following are entity-types and their property references.
BroadcastFrequencySpecification
The BroadcastFrequencySpecification
entity-type is associated with the
broadcastfrequency
property.
The BroadcastFrequencySpecification
entity-type is used to identify the radio
station by its frequency. In the case of digital radio, the frequency channel
might carry multiple sub-channels with different programs. In those cases, the
broadcastSubChannel
value is used to locate the target radio station within
the frequency channel.
For internet-only radio stations, the BroadcastFrequencySpecification
object
isn't needed, so use the string value INTERNET_STREAM
instead.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to BroadcastFrequencySpecification . |
broadcastFrequencyValue |
Text |
Required: The digit part of the frequency. For example, "89.3." For Digital Audio Broadcasting (DAB) stations, this must be the block number. For example, "12A." |
broadcastSignalModulation |
Text |
Required: The signal modulation part of the frequency. The value must be one of: "FM", "AM", "HD", "DAB" or "DAB+". |
broadcastSubChannel |
Text |
Required if applicable: The subchannel in the case of digital radio. For DAB and DAB+ stations, this value is the service ID. For example, "HD1"–"HD8" are possible values for HD radio, and "C8D8" is a possible value for DAB. |
The following are BroadcastFrequencySpecification
examples:
FM (HD)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
AM
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "1010",
"broadcastSignalModulation": "AM",
},
DAB
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "12B",
"broadcastSignalModulation": "DAB",
"broadcastSubChannel": "C8D8"
},
Internet-Only
"broadcastFrequency": "INTERNET_STREAM",
Organization
The Organization
entity-type is associated with the broadcaster
or
broadcastAffiliateOf
properties.
In the RadioBroadcastService
specification, the Organization
type is used
for both broadcaster
and broadcastAffiliateOf
properties.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to Organization . |
@id |
URL |
Required: A globally unique ID for the organization that's in a URI format. The ID must be stable and not change over time. It's treated as an opaque string and doesn't have to be a working link. |
name |
Text |
Required: The name of the organization. |
sameAs |
URL |
This property is a URL to a reference web page that unambiguously identifies the organization. For example, a Wikipedia page for the organization, or the organization’s official website. |
The following are Organization
examples:
SINGLE
"broadcaster": {
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio",
"sameAs": "https://www.billyradio-example.org/",
"name": "Billy Radio Inc"
},
MULTIPLE OWNERS
"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",
}
],
MULTIPLE NETWORKS
"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
The RadioBroadcastService
entity-type is associated with the parentService
property.
The parentService
property is used for a repeater or translator station to
indicate its parent station.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to RadioBroadcastService . |
@id |
URL |
Required: A globally unique ID in a URL format that represents the parent radio station. If the parent radio station is also included in your feed as a separate entity, ensure that both IDs are the same. |
name |
Text |
Required: The name of the parent radio station. |
sameAs |
URL |
The URL to a reference web page that unambiguously identifies the parent station. For example, a Wikipedia page for the parent station. |
The following is aRadioBroadcastService
example:
"parentService": {
"@type": "RadioBroadcastService",
"@id": "https://www.tjradio.org/stations?id=10",
"name": "GQED-FM",
"sameAs": "https://en.vikibedia.org/wiki/GQED-FM"
},
ImageObject
The ImageObject
entity-type is associated with the logo
property.
The logo
property is used to provide the logo image for the given radio station. These images are displayed alongside content as a deep link for a given radio entity.
Property | Expected Type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to ImageObject . |
height |
Integer |
Height of the image in pixels. |
width |
Integer |
Width of the image in pixels. |
contentUrl |
URL |
Required: A URL where the image can be fetched. |
regionsAllowed |
Country |
The countries where the media is allowed. If the property isn't specified, then it's assumed that the image is allowed to be displayed in all locales. To submit different images per region, add multiple ImageObject types, each with its own set of countries and a corresponding image URL. |
Country
The Country
entity-type is associated with the logo.regionsAllowed
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Always set this property to Country . |
name |
Text |
The ISO 3166-1 alpha-2. For example, "GB" or "US." |
The following are ImageObject
examples:
UNIVERSAL LOGO
"logo": {
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
LOGO BY COUNTRY
"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
The PropertyValue
entity-type is associated with the identifier
property.
If you use a third-party ID system for your content, such as the Gracenote IDs
(TMS), then the ID can be provided by the identifier
property. This improves
the accuracy of Google’s reconciliation of your radio stations.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to PropertyValue . |
propertyID |
Text |
Required: The type of specified ID. We support the following ID types:
|
value |
Text |
The URL to a reference web page that unambiguously identifies the parent station. For example, a Wikipedia page for the parent station. |
The following is a PropertyValue
example:
"identifier": {
"@type": "PropertyValue",
"propertyID": "WIKIDATA_ID",
"value": "Q795598"
},
PopularityScoreSpecification
The PopularityScoreSpecification
entity-type is associated with the
popularityScore
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to PopularityScoreSpecification . |
value |
Number |
Required: A positive numeric value that's compared with other entities from your catalog. The bigger number represents the higher popularity. |
eligibleRegion |
Country |
A country or a list of the regions to which the popularity score is applicable. If the popularity score is globally applicable, simply use earth as the text value.If specific regions need to be listed, use the Country type.If this property is left out, the eligibleRegion defaults to earth . |
Country
The Country
entity-type is associated with the
popularityScore.eligibleRegion
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to Country . |
name |
Text |
Required: The ISO 3166-1 alpha-2. For example, "GB" or "US." |
The following are PopularityScoreSpecification
examples:
GLOBAL POPULARITY
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
COUNTRY-SPECIFIC
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
City, State, Country, AdministrativeArea
The City
, State
, Country
, and AdministrativeArea
entity-types are
associated with the areaServed
property.
The areaServed
property helps you select the most appropriate station based on
the user’s location information. Examples of location information are user
queries such as "a radio station near me" or "local news radio."
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to one of the following entity types: City ,State , Country , or AdministrativeArea . |
name |
Text |
Required: The name of the city, state, country, or area. Provide the most granular region. Also, provide the containing chain. Use the following format: city, state, country. |
The following are areaServed
examples:
CITY
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
STATE
"areaServed": [
{
"@type": "State",
"name": "California, US"
},
{
"@type": "State",
"name": "Nevada, US"
}
],
COUNTRY
"areaServed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "Australia"
}
],
ADMINISTRATIVEAREA
"areaServed": [
{
"@type": "AdministrativeArea",
"name": "Cape Cod, Massachusetts, US"
}
],
ListenAction
The ListenAction
entity-type is associated with the potentialAction
property.
The ListenAction
property defines your deep links for playback. It also defines
the criteria for the users to access the content. For example, geo/chronal/login/subscription status
.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to ListenAction . |
target |
EntryPoint |
Required: The specifications of your deep link. It includes the supported platform information. There can be multiple EntryPoint entity-types to define different deep links for different platform sets. |
actionAccessibilityRequirement |
ActionAccessSpecification |
Required: The definition of user requirements to access this entity. If multiple ActionAccessSpecification entity-types are present, a user that matches any of the specification criteria are able to access the content. |
EntryPoint
The EntryPoint
entity-type is associated with the potentialAction.target
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to EntryPoint . |
urlTemplate |
Text |
Required: The link that initiates the playback of your content. |
actionPlatform |
Text |
Required: The platforms that the deep link is valid for. The following are possible values:
|
ActionAccessSpecification
The ActionAccessSpecification
entity-type is associated with the
potentialAction.actionAccessibilityRequirement
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to ActionAccessSpecification . |
category |
Text |
Required: The type of access requirement. This must be one of the following values:
|
availabilityStarts |
DateTime |
The start time of the availability window. Use this property to control the exact time when this content is available to users. |
availabilityEnds |
DateTime |
The end time of the availability window. Use this property to control the exact time when this content is no longer available to users. |
eligibleRegion |
Country |
The country that's eligible for the Offer . Use this property to control the country or region where this content should or shouldn't be available. |
requiresSubscription |
MediaSubscription |
The subscription package required to access the content. If your service offers multiple subscription packages, this property is required. If your service is free, or there's only a single tier of subscription service, then you can skip this property. |
Country
The Country
entity-type is associated with the
potentialAction.actionAccessibilityRequirement.eligibleRegion
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to Country . |
name |
Text |
Required: The ISO 3166-1 alpha-2 country code. |
MediaSubscription
The MediaSubscription
entity-type is associated with the
potentialAction.actionAccessibilityRequirement.requiresSubscription
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to MediaSubscription . |
@id |
Text |
Required: A globally unique ID for the subscription package in a URI format. The ID must be stable and not change over time. It's treated as an opaque string and doesn't have to be a working link. |
name |
Text |
Required: The name of the subscription package. For example, "G-Radio Premium" or "A-Radio Basic." |
expectsAcceptanceOf |
Offer |
The Offer type associated with the purchase of the Media Subscription. This property is used to express the price of the subscription. |
Offer
The Offer
entity-type is associated with the
potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf
property.
Property | Expected type | Description |
---|---|---|
@type |
Text |
Required: Always set this property to Offer . |
price |
Number |
Required: The price of the subscription. |
priceCurrency |
Text |
Required: The currency of the price in a three-letter ISO 4217 format. |
seller |
Organization |
The organization that offers the subscription or purchase of the action. Use the same schema as described in the Organization section. |
The following are ListenAction
examples:
UNIVERSAL DEEP LINK
"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"
}
}
},
PLATFORM SPECIFIC
"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"
}
}
]
},
Full feed example
In this full feed example, we present a hypothetical radio data provider: TJ_RADIO. TJ_RADIO provides us with listen actions for radio data, along with the affiliation and ownership information. In this feed, 3 radio networks (provide content to affiliate stations) are presented GPR, GRI and G-music. Additionally, 3 radio stations are presented: GQED, GQEI and G-music.
- GQED is owned by GQED Inc and GPCB, two separate organizations. Also, GQED is affiliated to GPR, as it broadcasts some of the content created by GPR and GPI.
- GQEI is owned by GQED Inc and GPCB also. It is a repeater/translator station of GQED, serving a different area. GQEI is also affiliated to GPR and GPI.
- G-music is an international station, which is owned by GRJ and affiliated to the radio network G-music (a different entity with the same name as the station). G-music stations are across theacross all the country and broadcast some of the content created by the radio network G-music.
Related pages
See the following pages for more information on topics related to the properties described on this page: