Skip to main content

​
/media//details

Devuelve detalles de la oferta y metadatos de uno o varios elementos. El dominio de estos URI es eds.xboxlive.com. La API de detalles difiere de la API Related y de la API Browse (cuando se pasa un identificador), ya que esas API devuelven información sobre otros elementos asociados al identificador especificado, ya sea de forma explícita o implícita, mientras que la API de detalles devuelve información adicional sobre el mismo elemento. Se pueden pasar varios identificadores de diferentes tipos de elemento multimedia en una única llamada (siempre que no sean de tipo ProviderContentID; vea más abajo), pero todos deben pertenecer al mismo grupo multimedia. Sin embargo, hay un par de escenarios de cliente en los que el autor de la llamada no conoce el grupo multimedia. La API lo admite al permitir un valor especial de “Unknown” para el grupo multimedia en las siguientes situaciones:
  • idType = XboxHexTitle, que generará elementos AppType o GameType
  • idType = ProviderContentId, que generará elementos MovieType o TVType
En el gráfico siguiente se resume la asignación completa de qué tipos de identificador se pueden proporcionar con qué grupos multimedia:

​
Notas sobre los parámetros

​
ProviderContentId

Se usa para buscar el identificador específico del proveedor. Por ejemplo, el identificador de Netflix o el identificador de Hulu. Cuando idType es ProviderContentId, solo se acepta un único valor. Esto se debe a que los ProviderContentId son el único tipo de identificador que puede contener el carácter ’.’. Dado que el carácter ’.’ también es el separador que usamos entre identificadores, existe ambigüedad entre lo que es un delimitador entre identificadores y lo que forma parte del propio identificador. El resto de la API funciona de la misma manera para los ProviderContentId, excepto la funcionalidad de búsqueda masiva.

​
Parámetros de URI

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | marketplaceId| string| Obligatorio. Valor de cadena que se obtiene de Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId.|

​
Métodos válidos

GET (/media//details)   Devuelve detalles de la oferta y metadatos de uno o varios elementos.

​
Consulte también

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