Live TV events

Live TV event entities allow Google to identify which Media Actions content is broadcast on a TV channel or live streamed on the Internet. With the live TV event information, Google can help users browse, discover, and watch TV shows, movies, daily news, and other live events that are broadcast in real time on your app or platform. Google TV displays this electronic programming guide at various places such as the 'On Now' tab.

For instance, if Google knows that MyFavoriteMovie, MyFavoriteTVShow, and MyFavoriteBasketballTeam game are broadcast on a TV channel, Google can better recognize the context of the following queries and guide users to your app or platform:

• "Hey Google, play MyFavoriteMovie"
• "Hey Google, play MyFavoriteTVShow"
• "Hey Google, play MyFavoriteBasketballTeam game"

Note: Google TV integrations require a minimum of 7 days (24X7) of TV schedule into the future to be provided in the feed for every BroadcastService in the provider's catalog. This means that if the feed was collected today, it would contain data from (today-1 to today+6 days). The recommended duration for the same is, however, 14 days (today-1 to today+13 days). Work with your Google contact to ensure this is in place.

Live TV event entity types

The BroadcastEvent entity is the schema.org representation of a time-slot of programming on a television channel or the internet. It captures the broadcasting schedule of a show (Movie, TVSeries, or TVEpisode or a SportsEvent) and other details such as the start and end time, and the channel on which the content will be broadcast (if applicable). For example, it might represent the 6 PM to 9 PM slot on Thursday on "24 Hour Free Movies" TV channel when the movie "X-Men" is broadcast.

The figure below shows how the BroadcastEvent entity links to the rest of the entities in the feed.

Figure 1. The links between the Live TV event entity types.

Depending on the type of content and its broadcasting medium, you need to use a different set of properties in BroadcastEvent to provide the details of the content and identify the deep link. Consider the following three scenarios:

Scenario	Example
Scenario 1	A TV show or movie is broadcast on a TV channel.
Scenario 2	A sports event (for example, a live soccer match) is broadcast live on a TV channel.
Scenario 3	A sports event is live streamed on the Internet.

Content description

In addition to capturing the timings of the event and the channel on which the event will be broadcast, the BroadcastEvent entity also references (using the workPerformed or broadcastOfEvent property) a top level TVSeries, TVEpisode, Movie or SportsEvent entity with detailed metadata. Google may use the details on these referenced entities to enhance the user experience. For example, Google may utilize the image or contentRatings provided on these referenced entities to enrich the Google TV Live tab.

Important: For providers working on a combined feed for Video on demand and Live TV integration, the following is a mandatory requirement.
If a given TVSeries, TVSeason, TVEpisode, Movie, SportsEvent entity is part of both the Video on demand catalog and Live TV catalog, then Google expects a single entity in the feed that can be referenced each time the entity airs whether it is Video on demand or on LiveTV.

The placement of deep link is important to convey if the entity belongs to the Video on demand catalog only or is also part of the Live TV catalog. A deep link on the TVSeries, TVSeason, TVEpisode, Movie, SportsEvent entity implies that the entity is part of the Video on demand catalog and may be Live TV catalog as well. For Live TV only TVSeries, TVSeason, TVEpisode, Movie, SportsEvent entities, no deep links should be provided on the TVSeries, TVSeason, TVEpisode, Movie, SportsEvent entity itself. Google picks up the deep link from the corresponding BroadcastService entity (which represents the TV channel). TVSeries, TVSeason, TVEpisode, Movie, SportsEvent entities that have a deep link and are also broadcast on some TV channel will be referenced to the channel EPG (represented by the BroadcastEvent entity). This will imply that they are available in both the Video on demand and the Live TV catalog.

• If the content is a TV show or movie, use the workPerformed property to include a Movie, TVSeries, or TVEpisode entity (Scenario 1).

  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
  

• If the content is a sports event, use the broadcastOfEvent property to include a SportsEvent entity (Scenario 2 and 3).

  "broadcastOfEvent": {
    "@type":"SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6",
  }
  

• If the channel is off air in between 2 events, set the offAir property to true to indicate that the given time slot holds no programming and that the channel is off air. Also set the entity name and description as "Off Air". When offAir property is set to true, no workPerformed or broadcastOfEvent property is required. Maximum length of such off air intervals should be 4 hours. In case the channel is off air for more than 4 hours, provide multiple BroadcastEvent entities in the feed spanning a maximum time window of 4 hours.

  "name": "Off Air",
  "description": "Off Air",
  "offAir": true
  

• In cases where you know that the channel is not off air but are not aware of the programming for the time slot, set the contentToBeAnnounced property to true to indicate that no details are available for the given time slot. Also set the entity name and description as "Content To Be Announced". When contentToBeAnnounced property is set to true, no workPerformed or broadcastOfEvent property is required.

  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "contentToBeAnnounced": true
  

• When you don't have enough metadata to create a top level entity that can be referenced using the workPerformed or broadcastOfEvent property, you can create the BroadcastEvent entity without providing either of workPerformed,broadcastOfEvent, offAir, or contentToBeAnnounced property. In such cases, the BroadcastEvent entity should try to capture as much available information as possible. For example, while not enough metadata might be available to create the Movie entity that can be referenced in the BroadcastEvent entity, the contentRating or image can be directly added to the BroadcastEvent entity.

Broadcast medium

The content can be broadcast either on a TV channel (BroadcastService) or live streamed on the Internet (WatchAction):

• TV Channel: If the content is broadcast on a TV channel, use the publishedOn property to include a BroadcastService entity (Scenario 1 and 2).

  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
  

• Channel-less (standalone) event: If the content is broadcast live as a streaming event, the publishedOn property is not required. Instead, directly use the potentialAction property in BroadcastEvent to provide the deep link of the event (Scenario 3). See the SportsEvent - boxing match (a streaming event) example.

Examples

Note: The examples below only show the entities most relevant to the scenario covered by the example. For example, several examples below only show BroadcastService entities or TVEpisode entities when it should be noted that the rest of the required entities required to fully represent the channel (TelevisionChannel, CableOrSatelliteService, Organization) or the episode (TVSeries, TVSeason) are not shown below for succinctness. Feed providers should ensure that the feed contains all required entity types.

Broadcast of a Movie on a TV channel

A movie is broadcast on the television network Example TV (BroadcastService) between 5 pm and 7 pm PT on July 12th, 2019.

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/movie/new_release",
  "name": "My Favorite Movie",
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "startDate": "2019-07-12T17:00-07:00",
  "endDate": "2019-07-12T19:00-07:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "Movie",
    "@id": "http://www.example.com/my_favorite_movie"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network",
  }
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Movie

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ]
}

Broadcast of a movie, which is also available on demand, on a TV channel

A movie is broadcast on the television network Example TV (BroadcastService) between 5 pm and 7 pm on July 12th, 2019. The movie is also available on Demand

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/movie/new_release",
  "name": "My Favorite Movie",
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "startDate": "2019-07-12T17:00-08:00",
  "endDate": "2019-07-12T19:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "Movie",
    "@id": "http://www.example.com/my_favorite_movie"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network",
  }
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Movie

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "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/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "John Doe spent years perfecting his survival skills in a tropical jungle.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ]
}

Broadcast of an episode of a TVSeries on a TV channel

A TV episode is broadcast on the television network Example TV (BroadcastService) between 9 pm and 9:30 pm on October 12th, 2019.

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://www.example.com/my_favorite_tv_show/s6/e2"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network",
  }
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s6/e2",
  "url": "http://www.example.com/my_favorite_tv_show/s6/e2",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_show/s6/e2",
  "episodeNumber": 2,
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s6",
    "seasonNumber": 6
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "Three Mice return to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

Broadcast of daily news on a TV channel

A daily news program, which can be represented as an episodeless TVSeries entity, is broadcast live on the television network Example TV (BroadcastService).

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/news/my_favorite_daily_news",
  "name": "My Favorite Daily News",
  "description": "Example TV's daily evening news program.",
  "startDate": "2019-07-12T20:00-08:00",
  "endDate": "2019-07-12T21:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "True",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/news/my_favorite_daily_news"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network",
  }
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://example.com/news/my_favorite_daily_news",
  "name": "My Favorite Daily News",
  "description": "Example TV's daily evening news program.",
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_daily_news",
  "popularityScore": {
      "@type": "PopularityScoreSpecification",
      "value": 4.1,
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    },
    "description": "This is my favorite daily news.",
    "actor": [
      {
        "@type": "Person",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      },
      {
        "@type": "Person",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
    ],
    "identifier": [
       {
         "@type": "PropertyValue",
         "propertyID": "IMDB_ID",
         "value":  "tt0903747"
       }
     ]
  }

Broadcast of a basketball game on a TV channel

A professional basketball league's championship game is broadcast live on the television network Example TV (BroadcastService).

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/basketball/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "startDate":"2019-06-16T20:00-08:00",
  "endDate":"2019-06-16T23:00-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "publishedOn":{
    "@type":"BroadcastService",
    "@id":"http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type":"SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6",
  }
}

SportsEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network",
  }
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Broadcast of a boxing match on the internet

A popular boxing match is broadcast live on the Internet as a streaming event (WatchAction).

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/20190616/johndoe_vs_janedoe",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "startDate":"2019-06-16T21:00-08:00",
  "endDate":"2019-06-16T21:30-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "broadcastOfEvent": {
    "@type":"SportsEvent",
    "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/premium/johndoe_vs_janedoe",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2019-06-01T10:00:00Z",
      "availabilityEnds": "2019-06-31T10:00:00Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/premium_subscription",
        "name": "Example Premium",
        "sameAs": "http://www.example.com/premium_subscription",
        "commonTier": true
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  }
}

SportsEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}