Skip to main content

GET (/media//details)

Retorna detalhes da oferta e metadados sobre um ou mais itens. O domínio desses URIs é eds.xboxlive.com.

Comentários

A SandboxId agora é recuperada da declaração no XToken e imposta. Se a SandboxId não estiver presente, o Entertainment Discovery Services (EDS) gerará um erro 400 Solicitação inválida.

Parâmetros de URI

Parâmetros da cadeia de consulta

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | | ids| string[]| Obrigatório. Todas as IDs (até 10) para as quais os detalhes serão retornados. Observe que qualquer ID que contenha caracteres não permitidos em uma URL (as IDs do tipo ProviderContentId normalmente são URLs completas e, portanto, contêm caracteres não permitidos) DEVE ser codificada em URL para ser enviada corretamente ao Entertainment Discovery Services (EDS). Observe também que isso só pode ser um único valor se o tipo de ID for ProviderContentId. Se for desejado mais de um ProviderContentId, várias chamadas deverão ser feitas ao EDS.| | IdType| string| Opcional. O tipo das IDs passadas no parâmetro ‘ids’. Os valores válidos são:
  • Canonical (Bing/Marketplace)
  • ZuneCatalog
  • ZuneMediaInstance (por exemplo, arquivo de música WMA de 132 kb)
  • AMG
  • MediaNet (pré-MusiWave)
  • XboxHexTitle (aplicativo em execução no console)
| | DesiredMediaItemTypes| string| Obrigatório se MediaGroup não for passado. Os dois não devem ser passados juntos. Os tipos de item de mídia das IDs. Todas as IDs fornecidas devem compartilhar o mesmo tipo. Se forem desejados vários tipos, passe todos os tipos possíveis, conforme descrito em IdType acima. Esse valor assume “Unknown” como padrão se não estiver presente, o que pode não ser válido para todos os tipos de ID. | | MediaGroup| string| Obrigatório se DesiredMediaItemTypes não for passado. Os dois não devem ser passados juntos.| | ConditionSets| string| Opcional. Os clientes podem solicitar a remoção de Availability com base em conjuntos de condições, que são pares chave-valor especificados por meio desta cadeia de consulta. Eles são usados para corresponder aos conjuntos de condições de uma disponibilidade. A lista de chaves que podem ser usadas para corresponder aos conjuntos de condições é a seguinte.
  • Platforms: onde o produto é compilado e pode ser jogado.
  • Subscriptions: lista de assinaturas compatíveis com essa disponibilidade (Gold ou Silver).
  • EntitlementIds: rastreadas depois que os usuários compram o jogo.
|

Corpo da resposta

Exemplo de resposta

O código JSON abaixo é a resposta à chamada /media/en-us/details?ids=6c5402e4-3cd5-4b29-a9c4-bec7d2c7514a&mediaGroup=GameType.

Confira também

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