Live TV event

The 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.

For instance, if Google knows that MyFavoriteMovie, MyFavoriteTVShow, and MyFavoriteBasketballTeam game are currently 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”

Service providers can use the BroadcastEvent, SportsEvent, MusicEvent, and Event (in addition to BroadcastService, Movie, TVSeries, TVSeason, and TVEpisode) markup objects to provide the details of TV programming or live events.

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 1 - A TV show or movie is broadcast on a TV channel.

Scenario 2 - A special event (for example, sports or music) is broadcast live on a TV channel.

Scenario 3 - A special event is live streamed on the Internet.

Content description

To obtain the metadata of a show or an event, a BroadcastEvent entity must have either a workPerformed or broadcastOfEvent property:

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

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.

Live TV event examples

The following examples demonstrate the common scenarios of the live TV event entities: