Skip to main content

​
API EDS auxiliaires

Plusieurs API Entertainment Discovery Services (EDS) ne fournissent pas directement d’informations sur le contenu, mais donnent des informations générales sur l’utilisation du service ou aident à piloter des modèles d’interface utilisateur courants.

​
API auxiliaires

​
Valeurs des paramètres d’API

Cette API décrit les paramètres pouvant être utilisés avec le service. Les informations renvoyées sont utilisables par l’interface utilisateur du client, car un texte localisé accompagne chaque paramètre. Aucune des API ci-dessous n’accepte de paramètres de requête. | API| URI| Description| | --- | --- | --- | --- | --- | --- | | Types| //metadata/mediaGroups| Liste complète des groupes de médias| | Types d’éléments multimédias par groupe de médias| //metadata/mediaGroups//mediaItemTypes| Liste des types d’éléments multimédias contenus dans le groupe de médias donné.| | Tous les types d’éléments multimédias| //metadata/mediaItemTypes| Liste complète des types d’éléments multimédias| | Champs par type d’élément multimédia| //metadata/mediaItemTypes//fields| Liste des champs d’un seul type d’élément multimédia| | Affineurs de requête| //metadata/mediaItemTypes//queryRefiners| Liste des affineurs de requête pris en charge pour le type d’élément multimédia donné| | Toutes les valeurs d’affineur de requête| //metadata/mediaItemTypes//queryRefiners/| Valeurs de l’affineur de requête spécifié pour le type d’élément multimédia donné| | Toutes les sous-valeurs d’affineur de requête| //metadata/mediaItemTypes//queryRefiners//subQueryRefinerValues| Liste des sous-valeurs d’une valeur d’affineur de requête donnée (par exemple, « sous-genres d’un genre donné »). La valeur d’affineur de requête est transmise sous forme de paramètre de chaîne de requête nommé « queryRefinerValue », ce qui permet de transmettre des valeurs d’affineur de requête contenant des caractères interdits dans les radicaux d’URI.| | Tris| //metadata/mediaItemTypes//sortOrders| Liste des ordres de tri pour le type d’élément multimédia donné|

​
Générateur de classification de contenu combinée

L’application d’un 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 possède son propre système de classification, mais ces systèmes de classification peuvent varier d’un pays/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. L’objectif est de 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 changer à terme, elles devraient changer très rarement (par exemple entre les versions d’EDS) et peuvent 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 rappeler 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’est effectué
Remarque :
Cela ne signifie pas que seul du contenu « sûr » est renvoyé : cela signifie que tout le contenu est renvoyé, y compris le contenu potentiellement explicite).

​
Nom de champ combiné

Par défaut, les API EDS renvoient un ensemble minimal très restreint de champs pour chaque élément :
  • Type d’élément multimédia
  • Groupe de médias
  • Id
  • Nom
Pour obtenir plus d’informations, les API acceptent un paramètre « fields » qui spécifie les données supplémentaires à renvoyer. Comme il existe de nombreux champs possibles, spécifier leur nom complet dans chaque appel d’API alourdirait considérablement la requête. À la place, les noms peuvent être transmis à cette API, qui génère une valeur beaucoup plus courte pouvant être transmise aux autres API. Pour toute API acceptant ce paramètre, la valeur fournie doit être le sur-ensemble de tous les champs de tous les types d’éléments multimédias spécifiés. Il n’est pas possible de spécifier des ensembles de champs différents pour différents types d’éléments multimédias. Toutefois, si un champ s’applique à un type d’élément multimédia mais pas à un autre, il n’apparaît que dans les types d’éléments multimédias pour lesquels des données existent (par exemple, si « AvatarBodyType » est inclus dans l’appel à l’API Nom de champ combiné, seuls les AvatarItems contiendront ce champ). Les valeurs renvoyées par cette API se prêtent très bien à la mise en cache ; en fait, elles ne devraient changer qu’entre les déploiements d’EDS. Si la mise en cache est souhaitée, il est recommandé que le cache ne dure pas plus longtemps que la session de l’utilisateur. En plus des noms de champs réels, cette API accepte « all » comme valeur valide. Cela génère une valeur contenant tous les champs qu’il est possible de spécifier. La valeur « all » sera probablement utilisée uniquement à des fins de développement, de débogage et de test.

​
Voir aussi

Parent
Référence supplémentaire
Informations complémentaires
URI Marketplace
Last modified on October 6, 2026