GET (/media//contentRating)
Obtient le jeton de classification du contenu. Le domaine de ces URI esteds.xboxlive.com.
Remarques
L’application du contrôle parental sur le contenu que les enfants sont autorisés à voir est une tâche complexe. Non seulement chaque type d’élément multimédia a son propre système de classification, mais ces systèmes de classification peuvent varier d’un pays ou d’une région à l’autre. Cela signifie que plusieurs éléments de données différents doivent être spécifiés pour filtrer correctement tous les éléments. Au lieu de spécifier tous les paramètres dans tous les appels d’API, cette API génère une valeur à transmettre aux paramètres combinedContentRating des autres API tout en communiquant les mêmes informations. Cela vise à faciliter l’utilisation et la maintenance des API, car les différents paramètres transmis à cette API sont regroupés en une seule valeur réutilisable pour les autres API. Bien que les valeurs exactes renvoyées par cette API puissent éventuellement changer, elles devraient changer très rarement (par exemple, entre les versions d’Entertainment Discovery Services (EDS)) et pourraient donc être mises en cache pendant de longues périodes. Toute API acceptant un paramètre combinedContentRating renvoie un message d’erreur explicite si la valeur transmise n’est pas valide, ce qui indique que l’appelant doit simplement appeler de nouveau cette API pour obtenir une valeur à jour. Si une API accepte un paramètre combinedContentRating, mais qu’aucun n’est fourni, aucun filtrage du contenu basé sur le contrôle parental n’aura lieu.Remarque :
Cela ne signifie pas que seul le contenu « sûr » est renvoyé : cela signifie que tout le contenu est renvoyé, y compris le contenu potentiellement explicite.