Skip to main content

GET (/media//details)

하나 이상의 항목에 대한 제안 세부 정보 및 메타데이터를 반환합니다. 이 URI의 도메인은 eds.xboxlive.com입니다.

설명

이제 SandboxId는 XToken의 클레임에서 검색되어 적용됩니다. SandboxId가 없으면 Entertainment Discovery Services(EDS)는 400 Bad request 오류를 발생시킵니다.

URI 매개변수

쿼리 문자열 매개변수

| 매개변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | ids| string[]| 필수. 세부 정보를 반환할 모든 ID(최대 10개)입니다. URL에 넣기에 부적합한 문자를 포함하는 모든 ID(ProviderContentId 유형 ID는 일반적으로 전체 URL 자체이므로 부적합한 문자를 포함함)는 Entertainment Discovery Services(EDS)로 제대로 전송되려면 반드시 URL로 인코딩되어야 합니다. 또한 ID 유형이 ProviderContentId인 경우 단일 값만 가능합니다. 여러 개의 ProviderContentId가 필요한 경우 EDS에 여러 번 호출해야 합니다.| | IdType| string| 선택 사항. ‘ids’ 매개변수에 전달된 ID의 유형입니다. 유효한 값은 다음과 같습니다.
  • Canonical (Bing/Marketplace)
  • ZuneCatalog
  • ZuneMediaInstance (예: 132 kb WMA 음악 파일)
  • AMG
  • MediaNet (MusiWave 이전)
  • XboxHexTitle (콘솔에서 재생되는 앱)
| | DesiredMediaItemTypes| string| MediaGroup이 전달되지 않은 경우 필수입니다. 둘 다 전달하면 안 됩니다. ID의 미디어 항목 유형입니다. 제공되는 모든 ID는 동일한 유형을 공유해야 합니다. 여러 유형이 필요하면 위 IdType에서 설명된 대로 가능한 모든 유형을 전달하세요. 이 값은 존재하지 않으면 기본적으로 “Unknown”으로 설정되며, 모든 ID 유형에 유효하지 않을 수 있습니다. | | MediaGroup| string| DesiredMediaItemTypes가 전달되지 않은 경우 필수입니다. 둘 다 전달하면 안 됩니다.| | ConditionSets| string| 선택 사항. 클라이언트는 이 쿼리 문자열을 통해 지정된 키-값 쌍인 조건 집합(condition set)에 기반하여 Availability 정리를 요청할 수 있습니다. 이는 가용성의 조건 집합에 대해 일치시키는 데 사용됩니다. 조건 집합과 일치시킬 수 있는 키 목록은 다음과 같습니다.
  • Platforms: 제품이 빌드되고 재생될 수 있는 위치입니다.
  • Subscriptions: 이 가용성에 대해 지원되는 구독 목록입니다(Gold 또는 Silver).
  • EntitlementIds: 사용자가 게임을 구매한 후 추적됩니다.
|

응답 본문

샘플 응답

아래의 JSON 코드는 /media/en-us/details?ids=6c5402e4-3cd5-4b29-a9c4-bec7d2c7514a&mediaGroup=GameType 호출에 대한 응답입니다.

참고 항목

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