Watch Actions' common properties

This section provides the details of the common properties of Watch Actions.

Action markup properties

Property Expected type Description
@type Text Required - Always set to WatchAction.
target EntryPoint Required - A target object that provides the mapping of deep links to various Google platforms.
target.@type Text Required - Always set to EntryPoint.
target.urlTemplate URL Required - A deep link that takes users to your app or platform and initiates playback of the content.
target.actionPlatform Text Required - The platforms that are mapped to urlTemplate. Media Actions support the following:
  • http://schema.org/DesktopWebPlatform: Search platform on desktop web browsers.
  • http://schema.org/MobileWebPlatform: Search platform on mobile web browsers.
  • http://schema.org/AndroidPlatform: Search and PlayGuide platforms on Android app.
  • http://schema.org/AndroidTVPlatform: Android TV platform on Android TV app.
  • http://schema.org/IOSPlatform: Search platform on iOS app.
  • http://schema.googleapis.com/GoogleVideoCast: Cast and Home platforms on a Chromecast device.
  • http://schema.googleapis.com/GoogleAudioCast: Cast and Home platforms on a Chromecast device (Listen Actions only).
See the Platform types section for requirements.
target.additionalProperty PropertyValue Required if applicable - A list of property-value pairs to represent additional properties of the deep link. This can include the following:
  • contentLanguage: The broadcast language (dub), in BCP 47 format. If the content is dubbed in a different language, this property is required. Use an array for multiple language codes.
  • subtitleLanguage: The languages of subtitles or captions, in BCP 47 format. Use an array for multiple language codes.
  • cameraAngle: The camera angle for the content; for example, "Eye-Level" and "High-Angle". If the content is available in different camera angles, this property is required. Use an array for multiple camera angles.
  • videoFormat: The file format used to store the digital video date; for example, "SD" for standard-definition and "HD" for high-definition. Use an array for multiple video formats.
See the additionalProperty example.
actionAccessibilityRequirement ActionAccessSpecification Required - An Action access specification object that describes the access requirement of the content. See Action Access Specification Properties.

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

Action access specification properties

Property Expected type Description
actionAccessibilityRequirement.@type Text Required - Always set to ActionAccessSpecification.
actionAccessibilityRequirement.category Text Required - An access requirement for the content. Use one of the following (see Action access requirement examples):
  • nologinrequired: The content does not require purchase or login.
  • free: The content requires users to be logged in and does not require a paid subscription.
  • subscription: The content requires users to be logged in with a paid subscription (for example, HBO Now).
  • externalsubscription: The content requires a subscription from a different service (for example, HBO GO requires a subscription from the cable provider).
  • rental: The content is available for a finite amount of time after purchase.
  • purchase: The content is available for an indefinite amount of time after purchase.
If an entity represents a group of content, you need to set category to the least restrictive access requirement of its content. For instance, if a TVSeries has a number of TVEpisode content that are nologinrequired and a few that are subscription, set this TVSeries to be nologinrequired.
actionAccessibilityRequirement.availabilityStarts Date Required - Date after which the action is available, in ISO 8601 format (including timezone).
  • The date can be set in the future.
actionAccessibilityRequirement.availabilityEnds Date Required - Date after which the action is no longer available, in ISO 8601 format (including timezone).
  • Must be equal or greater than 72 hours after availabilityStarts.
  • If the content is always available after it's published, set this date to be 20 years from the current date.
actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape, or Text Required - Regions where the content is available. Use the special string EARTH if the content is available globally.
actionAccessibilityRequirement.ineligibleRegion Country, City, State, or GeoShape Required if applicable - Regions where the content is restricted. You don’t need to provide this property if the content is available everywhere within eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription Required if category is subscription or externalsubscription - The details of the subscription that users need in order to access the content. See Media subscription properties.
actionAccessibilityRequirement.expectsAcceptanceOf Offer Required if the content requires a purchase - The details of the offer associated with the content. Provide the price information for the following cases:
  • One-time purchase content (rental or purchase)
  • Subscription-based content that requires an additional purchase from subscribers (subscription or externalsubscription)
If the price is 0.00, do not provide this property. See Offer properties.

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

Media subscription properties

Property Expected type Description
requiresSubscription.@type Text Required - Always set to MediaSubscription
requiresSubscription.@id URL Required - The unique ID for the subscription. If the content is accessible via different subscriptions, each subscription must have a unique ID.
requiresSubscription.name Text Required - The name of the subscription. Notice the following:
  • If the content is accessible via different subscriptions, this name needs match the name in your user authentication system. For example, if a user can access the content based on the subscription called Package 1, but the authentication system uses the name PKG1a, use PKG1.
  • For TVE Providers, this is the authenticator name registered with your TVE authenticator. It is a string that uniquely identifies your service name with the TVE Authenticator.
requiresSubscription.sameAs URL The page that describes the subscription.
requiresSubscription.identifier Text An entitlement identifier (entitlementId) required to access the content.
requiresSubscription.authenticator Organization Required if category is externalsubscription - A container that provides the details of the external provider's authenticator.
requiresSubscription.authenticator.@type Text Required if category is externalsubscription - Always set to Organization.
requiresSubscription.authenticator.name Text Required if category is externalsubscription - The name of the authentication service. For TVE providers, set it to TVE

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

Offer properties

Property Expected type Description
expectsAcceptanceOf.@type Text Required - Always set to Offer.
expectsAcceptanceOf.price Number Required - The purchase price of content.
expectsAcceptanceOf.priceCurrency Text Required - The currency of the price in 3-letter ISO 4217 format.
expectsAcceptanceOf.seller Organization The organization that offers the purchase of content.
expectsAcceptanceOf.seller.@type Text Always set to Organization.
expectsAcceptanceOf.seller.name Text The name of the seller.
expectsAcceptanceOf.seller.sameAs Text The URL of a web page that identifies the seller; for example, the seller's homepage.

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

Identifier properties

Property Expected type Description
@type Text Required - Always set to PropertyValue.
propertyID PropertyValue Required - We support the following ID types:
  • TMS_ROOT_ID: The Gracenote (TMS) Root ID (for example, 15829).
  • TMS_ID: The Gracenote (TMS) Variant ID (for example, MV000398520000).
  • WIKIDATA_ID: The WikiData ID (for example, Q134773).
  • IMDB_ID: The IMDB ID (for example, tt0109830).
  • _PARTNER_ID_: The ID used by a service provider to identify a BroadcastService entity (for example, exampleTV-drama-12345).
value Text Required - The value for the specified ID system.