Determining the age rating for a channel, event, or content
Overview
To enforce parental controls, a client application needs to know the age rating for a content, series, season, channel, or event that the user wants to watch so it can prompt for the parental PIN where appropriate.
When the app requests content, series, season, channel, or event metadata from the Metadata Service (MDS) or from Content Discovery Facade, the response includes the age rating. See the examples below.
Requests
The metadata requests for contents, series, seasons, channels, and events are as follows.
In the response, look for the Ratings block for each entity. This contains the rating threshold for each applicable ratings body.
Contents
https://<host>:<port>/metadata/delivery/v2/<provider>/vod/editorialsThis call is explained in more detail in Retrieve content information.
Series and seasons
If a series or season does not have ratings set on it explicitly, OpenTV Video Platform calculates the ratings based on the ratings of the episodes/seasons as follows:
If a season does not have ratings set on it, it is assigned the rating of the episode with the highest rating.
If a series does not have ratings, but the seasons under it do, it is assigned the rating of the season with the highest rating.
If a series does not have rating and neither does its seasons, it is assigned the rating of the episode with the highest rating across all the seasons.
Live/BTV
https://<host>:<port>/metadata/delivery/<provider>/btv/seriesThis call is explained in more detail in Retrieving series and season information.
VOD
https://<host>:<port>/metadata/delivery/<provider>/vod/seriesThis call is explained in more detail in Retrieving VOD series information.
Channels
https://<host>:<port>/metadata/delivery/<provider>/btv/servicesThis call is explained in more detail in Retrieving channel lists.
Events
Depending on your requirements, use one of the following endpoints to get event metadata:
https://<host>:<port>/metadata/v1/epgThis call is explained in more detail in Retrieving events for an EPG window – pre-defined queries.
https://<host>:<port>/metadata/delivery/<provider>/btv/programmesThis call is explained in more detail in Retrieving events for an EPG window – advanced queries.
See also
For full details of these APIs, see: