API auxiliares de EDS
Existen varias API de Entertainment Discovery Services (EDS) que no proporcionan directamente información sobre el contenido, sino que ofrecen información general sobre cómo usar el servicio o ayudan a controlar modelos de interfaz de usuario comunes.API auxiliares
Valores de parámetros de API
Esta API describe los parámetros que se pueden usar con el servicio. La información devuelta puede usarse en la interfaz de usuario del cliente, ya que cada parámetro va acompañado de texto localizado. Ninguna de las API siguientes acepta parámetros de consulta. | API| URI| Descripción| | --- | --- | --- | --- | --- | --- | | Tipos| //metadata/mediaGroups| La lista completa de grupos multimedia| | Tipos de elementos multimedia por grupo multimedia| //metadata/mediaGroups//mediaItemTypes| La lista de tipos de elementos multimedia contenidos en el grupo multimedia especificado.| | Todos los tipos de elementos multimedia| //metadata/mediaItemTypes| La lista completa de tipos de elementos multimedia| | Campos por tipo de elemento multimedia| //metadata/mediaItemTypes//fields| La lista de campos de un único tipo de elemento multimedia| | Refinadores de consulta| //metadata/mediaItemTypes//queryRefiners| La lista de refinadores de consulta admitidos para el tipo de elemento multimedia especificado| | Todos los valores de refinador de consulta| //metadata/mediaItemTypes//queryRefiners/| Los valores del refinador de consulta especificado para el tipo de elemento multimedia indicado| | Todos los subvalores de refinador de consulta| //metadata/mediaItemTypes//queryRefiners//subQueryRefinerValues| La lista de subvalores para un valor de refinador de consulta determinado (por ejemplo, “subgéneros de un género determinado”). El valor del refinador de consulta se pasa como parámetro de cadena de consulta denominado “queryRefinerValue”, lo que permite pasar valores de refinador de consulta con caracteres prohibidos en las raíces de URI.| | Ordenaciones| //metadata/mediaItemTypes//sortOrders| La lista de criterios de ordenación para el tipo de elemento multimedia especificado|Generador de clasificación de contenido combinada
Aplicar controles parentales sobre el contenido que los niños pueden ver es una tarea complicada. No solo cada tipo de elemento multimedia tiene su propio sistema de clasificación, sino que esos sistemas de clasificación pueden variar de un país o región a otro. Esto significa que hay que especificar varios datos diferentes para filtrar correctamente todos los elementos. En lugar de especificar todos los parámetros en todas las llamadas a la API, esta API genera un valor que se pasa a los parámetros combinedContentRating de otras API y transmite la misma información. Está diseñada para que las API sean más fáciles de usar y mantener, ya que los varios parámetros que se pasan a esta API se condensan en un único valor reutilizable para las demás API. Aunque los valores exactos devueltos por esta API pueden llegar a cambiar, deberían cambiar con muy poca frecuencia (por ejemplo, entre versiones de EDS) y, por tanto, podrían almacenarse en caché durante períodos prolongados. Cualquier API que acepte un parámetro combinedContentRating devolverá un mensaje de error significativo si el valor pasado no es válido, lo que indica que el autor de la llamada simplemente necesita volver a llamar a esta API para obtener un valor actualizado. Si una API acepta un parámetro combinedContentRating pero no se proporciona ninguno, no se realizará ningún filtrado de contenido basado en los controles parentales.Nota:
Esto no significa que solo se devuelva contenido “seguro”, sino que se devuelve todo el contenido, incluido el contenido potencialmente explícito.
Nombre de campo combinado
Las API de EDS devuelven de forma predeterminada un conjunto mínimo muy reducido de campos para cada elemento:- Tipo de elemento multimedia
- Grupo multimedia
- Id
- Nombre