/media/{marketplaceId}/details
반환값은 하나 이상의 항목에 대한 세부 정보 및 메타데이터를 제공합니다.
이 URI의 도메인은 eds.xboxlive.com입니다.
해당 API가 명시적 또는 묵시적으로 특정 ID와 관련된 다른 항목에 대한 정보를 반환하므로 관련 API 및 찾아보기 API는 세부 정보 API와 다르며(ID에서 전달할 때), 이러한 세부 정보 API는 동일한 항목에 대한 추가 정보를 반환합니다.
여러 미디어 항목 유형의 여러 ID는 한 번의 호출로 전달될 수 있지만(유형이 ProviderContentID가 아닌 경우, 아래 참조) 모두 동일한 미디어 그룹에 속해야 합니다. 하지만 호출자가 미디어 그룹에 대해 알지 못하고 있는 몇 가지 클라이언트 시나리오가 있습니다. API는 다음과 같은 경우 미디어 그룹에 대해 "알 수 없음"이라는 특수 값을 허용하여 이 기능을 지원합니다.
- idType = XboxHexTitle(AppType 또는 GameType 항목 생성)
- idType = ProviderContentId(MovieType 또는 TVType 항목 생성)
다음 차트에는 미디어 그룹과 함께 제공될 수 있는 ID 유형에 대한 전체 매핑이 요약되어 있습니다.
| ID 유형 | AppType | GameType | MovieType | MusicArtistType | MusicType | TVType | WebVideoType | 알 수 없음 |
|---|---|---|---|---|---|---|---|---|
| Canonical | Y | Y | Y | Y | Y | Y | Y | N |
| ZuneCatalog | N | N | Y | Y | Y | Y | N | N |
| ZuneMediaInstance | N | N | Y | N | Y | Y | N | N |
| Offer | Y | Y | Y | N | Y | Y | N | N |
| AMG | N | N | N | N | Y | N | N | N |
| MediaNet | N | N | N | N | Y | N | N | N |
| XboxHexTitle | Y | Y | N | N | N | N | N | Y |
| ProviderContentId | N | N | Y | N | N | Y | N | Y |
매개 변수 정보
ProviderContentId
공급자별 ID(예: Netflix ID 또는 Hulu ID)를 조회하는 데 사용됩니다.
idType이 ProviderContentId이면 단일 값만 허용됩니다. 이는 ProviderContentId가 '.' 문자를 포함할 수 있는 유일한 ID 유형이기 때문입니다. '.' 문자는 ID 사이에 사용되는 구분 기호이기 때문에 ID 사이의 구분 문자와 ID 자체의 구분 문자 사이에 모호성이 있습니다. 나머지 API는 대량 조회 기능을 제외하고 ProviderContentId에 대해 동일한 방식으로 작동합니다.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| marketplaceId | 문자열 | 필수. Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId에서 획득한 문자열 값입니다. |
유효한 메서드
GET(/media/{marketplaceId}/details)
반환값은 하나 이상의 항목에 대한 세부 정보 및 메타데이터를 제공합니다.