Skip to main content

​
GET (/media//fields)

Obtiene el token de campos. El dominio de estos URI es eds.xboxlive.com.

​
Comentarios

Las API de Entertainment Discovery Services (EDS), de forma predeterminada, devuelven un conjunto mínimo muy pequeño de campos para cada elemento:
  • Tipo de elemento multimedia
  • Grupo multimedia
  • Id.
  • Nombre
Para obtener más información, las API aceptan un parámetro fields que especifica qué datos adicionales se deben devolver. Dado que hay muchos campos posibles, especificar su nombre completo en cada llamada API sobrecargaría considerablemente la solicitud. En su lugar, los nombres se pueden pasar a esta API, que generará un valor mucho más pequeño que se puede pasar a las demás API. Para cualquier API que acepte este parámetro, el valor proporcionado debe ser el superconjunto de todos los campos de todos los tipos de elemento multimedia especificados. No es posible especificar conjuntos de campos diferentes para tipos de elemento multimedia diferentes. Sin embargo, si un campo se aplica a un tipo de elemento multimedia pero no a otro, solo aparecerá en los tipos de elemento multimedia donde existan datos (por ejemplo, si “AvatarBodyType” se incluye en la llamada a GET (/media/{marketplaceId}/fields), solo los AvatarItems contendrán el campo). Los valores devueltos por esta API son altamente almacenables en caché; de hecho, no deberían cambiar excepto entre implementaciones de EDS. Se recomienda que, si se desea el almacenamiento en caché, la caché no dure más que la sesión del usuario. Además de aceptar los nombres de campo reales, esta API acepta “all” como valor válido. Esto generará un valor que contiene cada campo que es posible especificar. Se recomienda usar el valor “all” solo con fines de desarrollo, depuración y pruebas. Como alternativa, puede enviar desired={list of fields separated by a '.'} a cualquier API que acepte el token fields. No se pueden pasar desired y fields juntos.

​
Parámetros de URI

​
Parámetros de cadena de consulta

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | desired| string| Obligatorio. La lista de campos separados por ’.’ que se deben devolver además del conjunto mínimo. No se garantiza que se devuelvan todos los campos especificados para cada objeto (puede que simplemente no existan datos para determinados elementos), pero no se devolverá ningún campo fuera del conjunto mínimo que no se especifique aquí. |

​
Consulte también

Elemento primario
/media//fields
Información adicional
Encabezados comunes de EDS Parámetros de EDS Refinadores de consulta de EDS URI de Marketplace Referencia adicional
Last modified on October 19, 2026