Skip to main content

​
/media//details

하나 이상의 항목에 대한 제안 세부 정보 및 메타데이터를 반환합니다. 이 URI의 도메인은 eds.xboxlive.com입니다. details API는 Related API 및 Browse API(ID를 전달할 때)와 다릅니다. 후자의 API는 명시적으로 또는 암시적으로 지정된 ID와 연결된 다른 항목에 대한 정보를 반환하는 반면, details API는 동일한 항목에 대한 추가 정보를 반환합니다. 서로 다른 미디어 항목 유형의 여러 ID를 단일 호출에 전달할 수 있지만(ProviderContentID 유형이 아닌 한 - 아래 참조), 모두 동일한 미디어 그룹에 속해야 합니다. 그러나 호출자가 미디어 그룹을 모르는 몇 가지 클라이언트 시나리오가 있습니다. 이 API는 다음 상황에서 미디어 그룹에 대해 “Unknown”이라는 특별한 값을 허용하여 이를 지원합니다.
  • idType = XboxHexTitle. AppType 또는 GameType 항목이 반환됩니다.
  • idType = ProviderContentId. MovieType 또는 TVType 항목이 반환됩니다.
다음 표는 어떤 ID 유형이 어떤 미디어 그룹과 함께 제공될 수 있는지에 대한 전체 매핑을 요약합니다.

​
매개변수 참고 사항

​
ProviderContentId

공급자별 Id를 조회하는 데 사용됩니다. 예: Netflix Id 또는 Hulu Id. idType이 ProviderContentId인 경우 단일 값만 허용됩니다. 이는 ProviderContentIds가 ’.’ 문자를 포함할 수 있는 유일한 ID 유형이기 때문입니다. ’.’ 문자는 또한 ID 간 구분자로도 사용되므로, ID 사이의 구분자인지 ID 자체의 일부인지 모호합니다. 대량 조회 기능을 제외하고 API의 나머지 부분은 ProviderContentIds에 대해 동일한 방식으로 작동합니다.

​
URI 매개변수

| 매개변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | marketplaceId| string| 필수. Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId에서 얻은 문자열 값입니다.|

​
유효한 메서드

GET (/media//details)   하나 이상의 항목에 대한 제안 세부 정보 및 메타데이터를 반환합니다.

​
참고 항목

상위 항목
Marketplace URIs
추가 정보
EDS Common Headers EDS Parameters EDS Query Refiners 추가 참조
Last modified on October 19, 2026