Skip to main content

​
/media//details

Retorna detalhes da oferta e metadados sobre um ou mais itens. O domínio desses URIs é eds.xboxlive.com. A API de detalhes difere da API Related e da API Browse (ao passar uma ID), pois essas APIs retornam informações sobre outros itens associados à ID fornecida, explícita ou implicitamente, enquanto a API de detalhes retorna informações adicionais sobre o mesmo item. Várias IDs de diferentes tipos de item de mídia podem ser passadas em uma única chamada (desde que não sejam do tipo ProviderContentID; veja abaixo), mas todas devem pertencer ao mesmo grupo de mídia. No entanto, há alguns cenários de cliente em que o chamador não conhece o grupo de mídia. A API dá suporte a isso permitindo um valor especial “Unknown” para o grupo de mídia nas seguintes situações:
  • idType = XboxHexTitle, que produzirá itens AppType ou GameType
  • idType = ProviderContentId, que produzirá itens MovieType ou TVType
A tabela a seguir resume o mapeamento completo de quais tipos de ID podem ser fornecidos com quais grupos de mídia:

​
Observações sobre parâmetros

​
ProviderContentId

É usado para pesquisar uma ID específica do provedor, por exemplo, ID da Netflix ou ID do Hulu. Quando idType é ProviderContentId, apenas um único valor é aceito. Isso ocorre porque ProviderContentIds são o único tipo de ID que pode conter o caractere ’.’. Como o caractere ’.’ também é o separador que usamos entre IDs, há ambiguidade entre o que é um delimitador entre IDs e o que faz parte da própria ID. O restante da API funciona da mesma forma para ProviderContentIds, exceto pela funcionalidade de pesquisa em massa.

​
Parâmetros de URI

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | marketplaceId| string| Obrigatório. Valor de cadeia de caracteres obtido de Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId.|

​
Métodos válidos

GET (/media//details)   Retorna detalhes da oferta e metadados sobre um ou mais itens.

​
Confira também

Pai
URIs do Marketplace
Mais informações
Cabeçalhos comuns do EDS Parâmetros do EDS Refinadores de consulta do EDS Referência adicional
Last modified on October 6, 2026