Content markup properties of radio stations

This section provides the details of the content markup properties for the RadioBroadcastService entity type.

Specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.googleapis.com", {"@language": "xx"}].
  • Where "xx" represents the language of the strings in the feed. Each root entity context should have it's @language set to the appropriate language code in BCP 47 format format. For example, if the language is set to Spanish, the names are assumed to be in Spanish even if the subtitle/dub language is in English.
@type Text Required - Always set to RadioBroadcastService.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's 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 Google uses to match the content in your feed to the content in Google's databases.
url must meet the following requirements:
  • url must be globally unique
  • url must contain a working canonical URL that Google can crawl.
  • url needs to point to a content description page that is not blocked by a paywall.
For playback's deep link, see the target object's urlTemplate property instead.
name Text Required - The name of the radio station; for example, "WXKS FM".
creator RadioStation Required - Describes the radio station.
creator.@type Text Required - Always set to RadioStation.
creator.name Text Required - The common name of the broadcast service itself or its parent network; for example "WXKS FM", or "NPR".
creator.@reverse.broadcastAffiliateOf BroadcastService Required - Container for the broadcast service that describes this radio station.
creator.@reverse.broadcastAffiliateOf.@type Text Required - Always set to BroadcastService.
creator.@reverse.broadcastAffiliateOf.name Text Required - The call sign of the radio station; for example, "WXKS FM".
creator.@reverse.broadcastAffiliateOf.broadcastDisplayName Text Required - The display name of the radio station; for example "Kiss 108"
creator.@reverse.broadcastAffiliateOf.broadcastFrequency BroadcastFrequencySpecification Required - The frequency and band on which the radio station broadcasts.
creator.@reverse.broadcastAffiliateOf.broadcastFrequency.@type Text Required - Always set this to BroadcastFrequencySpecification.
creator.@reverse.broadcastAffiliateOf.broadcastFrequency.broadcastFrequencyValue Text Required - The numerical part of the broadcast frequency.
creator.@reverse.broadcastAffiliateOf.broadcastFrequency.broadcastSignalModulation Text Required - The band/modulation part of the broadcast frequency.
creator.@reverse.broadcastAffiliateOf.areaServed AdministrativeArea Required - The area that this radio station serves. Note that while areaServed can also be of type Place, GeoShape or Text, we highly recommend using AdministrativeArea format to denote the service area that users are likely to associate with the radio station.
creator.@reverse.broadcastAffiliateOf.areaServed.@type Text Required - Always set this to a subtype of AdministrativeArea; for example, City.
creator.@reverse.broadcastAffiliateOf.areaServed.name Text Required - The common name of the area.
creator.@reverse.broadcastAffiliateOf.sameAs URL A URL to a reference web page that can identify the affiliated broadcast; for example, the Wikipedia page of the affiliated broadcast.
potentialAction ListenAction Required - An Action markup object that provides the details of the action. See the Action markup properties for details.
keywords Text A list of keywords ("rock", "pop"), moods ("happy", "moody"), activities ("exercise", "relaxing"), or other terms related to the radio station.
description Text A brief description of the radio station. 300-character limit.
isFamilyFriendly Boolean Indicates whether this content is family friendly (that is, the content is suitable for all members of a family, including children). Google products may use isFamilyFriendly when determining a song to play.
popularityScore PopularityScoreSpecification 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 needs to be consistent across your feeds, among all the entities in your catalog. By default, an entity's popularity score is set to 0.
popularityScore.@type Text Always set to PopularityScoreSpecification.
popularityScore.value Number A non-negative numeric value that indicates the popularity of the entity; a higher score means higher popularity.
popularityScore.eligibleRegion Country Region(s) where this popularity score is applicable. If the popularity score is globally applicable, set to EARTH. By default, this property is set to EARTH.
Note: Locale-specific popularity takes precedence over global (EARTH) popularity

Example

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/radio/ABC103-Boston/",
  "url":"http://www.example.com/radio/ABC103-Boston/",
  "name":"ABC 103FM",
  "creator": {
     "@type": "RadioStation",
     "name": "My Favorite Radio Station",
     "@reverse": {
       "broadcastAffiliateOf": {
         "@type": "BroadcastService",
         "name": "XYZ-FM",
         "broadcastDisplayName": "ABC 103",
         "broadcastFrequency":"103 FM",
         "sameAs":"https://en.wikipedia.org/wiki/XYZ-FM",
         "description":"ABC 103 -- Boston's rock music station",
         "areaServed": {
           "@type": "City",
           "name": "Boston, MA"
        }
      }
    }
  },
  "potentialAction":{
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/radio/ABC103-Boston?autoplay=true",
      "actionPlatform":[
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.googleapis.com/GoogleAudioCast",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"NoLoginRequired",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 86,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"ABC 103 -- Boston's rock music station",
  "keywords": [
    "rock",
    "hits"
  ]
}

Check out the following pages for the topics related to these properties: