Watch Actions

Watch Actions are Media Actions for video content. For more information about Media Actions generally, see: Introduction

Action behavior

The specific requirements for each type are:

Movie

  • Movie Watch Actions are required for all movies available in your catalog
  • Content must autoplay on all platforms
  • If sign-in is required, the initiated action should begin once authentication is completed
  • If user state is tracked, playback should resume where the user left off within the movie
  • If user state is not tracked, or this is the first time a user is initiating the movie, playback should start at the beginning of the movie

TVSeries

  • TVSeries Watch Actions are required for all shows available in your catalog
  • Content must autoplay on the Cast and AndroidTV platform. Autoplay is recommended on all other platforms, however it is acceptable to have playback available behind one additional click
  • If sign-in is required, the initiated action should begin once authentication is completed
  • If user state is tracked, playback should resume where the user left off within the show (i.e. specific episode and point within episode)
  • If user state is not tracked, or this is the first time a user is initiating the show, playback should start according to the following guidelines depending on the nature of your content and service:
    • For shows consumed in batch, initiate the earliest available episode within the series
    • For catch up TV, initiate the most recent episode. Do not hard code to the deeplink for the latest episode as this will cause freshness issues when serving content. Instead provide a virtual link that resolves to the most recent episode.
    • If you are unsure of what to do for your service, please work with your contact at Google to determine the appropriate behaviour.

TVEpisode

  • TVEpisode Watch Actions are required for all episodes available in your catalog
  • Content must autoplay on all platforms
  • If sign-in is required, the initiated action should begin once authentication is completed
  • If user state is tracked, playback should resume where the user left off within the episode
  • If user state is not tracked, or this is the first time a user is initiating the episode, playback can start at the beginning of the episode

TVSeason

  • TVSeason Watch Actions are optional, but if you choose to provide TVSeason Watch Actions, you must provide them for all shows in your catalog
  • Content must autoplay on the Cast and AndroidTV platform. Autoplay is recommended on all other platforms, however it is acceptable to have playback available behind one additional click
  • If sign-in is required, the initiated action should begin once authentication is completed
  • If user state is tracked, playback should resume where the user left off within the season (ie specific episode and point within episode)
  • If user state is not tracked, or this is the first time a user is initiating the season, playback should start from the first episode of the season

For mobile platforms (Android/iOS) - If an action is initiated when the app isn't installed, one of the following must happen:

  • The user is directed to a webpage where they can watch the content
  • The user is directed to a webpage where they are prompted to download the app w/ only one (intuitive) click to the app store.
  • The user is directed to the app store to download the app

If you are unsure of what to do for your service, please work with your contact at Google to determine the appropriate behaviour.