Overview
To enforce parental controls, a client application needs to know the age rating for content, channel, or event that the user wants to watch so it can prompt for the parental PIN where appropriate.
When the app requests channel, event, or content metadata from the Metadata Service (MDS), the response includes the age rating. See the examples below.
Requests
The metadata requests for contents, 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/editorials
This call is explained in more detail in Retrieve content information.
Channels
https://<host>:<port>/metadata/delivery/GLOBAL/btv/services
This 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>/<endpoint>/metadata/epg
This call is explained in more detail in Retrieving events for an EPG window – pre-defined queries.
https://<host>:<port>/metadata/delivery/<provider>/btv/programmes
This call is explained in more detail in Retrieving events for an EPG window – advanced queries.
See also
For full details of these API, see the Metadata Server (MDS) API Documentation.