EDS 쿼리 구체화
다음 매개 변수를 사용해 엔터테인먼트 검색 서비스(EDS) 쿼리를 더 표적화된 일련의 항목으로 조정할 수 있습니다. 어떤 API에서도 이 매개 변수는 필요하지 않지만 쿼리 구체화를 수락하는 모든 API에서는 허용됩니다.
매개 변수 이름은 모든 "queryRefiners" 매개 변수에 값으로 전달할 수 있습니다. 이렇게 전달하면 요청에 쿼리 구체화가 적용되어 쿼리 구체화의 각 값으로 세분화된 채 요청이 반복되는 경우 반환될 항목의 수가 반환됩니다.
실제 작동 방식은 다음과 같습니다.
- "queryRefiners=genre" 매개 변수를 포함해 찾아보기 API에 대한 호출이 이루어집니다.
- API는 게임 8개를 반환합니다. 항목뿐 아니라 항목이 있는 각 장르의 목록이 해당 장르에 속한 항목의 수와 함께 반환됩니다. 이 게임에서는 "슈팅: 3 퍼즐: 5"가 될 수 있습니다.
- 두 번째 쿼리가 실행됩니다. "genre=Shooter"가 추가되는 것을 제외하면 첫 번째와 동일합니다.
- 이제 응답에는 모두 "슈팅" 범주에 속하는 세 가지 게임만 포함되어 있습니다.
| 매개 변수 | [데이터 형식(Data Type)] | 설명 |
|---|---|---|
| 10년 | 문자열 | 10년의 기간으로서 이 기간 중에 모든 항목을 릴리스했어야 합니다. |
| 장르 | 문자열의 배열 | 모든 항목에 있어야 하는 장르의 목록입니다. |
| labelOwner | 문자열 | 아티스트, 앨범 또는 트랙과 관련된 음악 레이블입니다. |
| network | 문자열의 배열 | 항목을 생성한 네트워크입니다. |
| 스튜디오 | 문자열의 배열 | 항목을 생성한 스튜디오입니다. |
| xboxAppCategories | 문자열의 배열 | 모든 Xbox 앱에 있어야 하는 범주의 목록입니다. |
| xboxAvatarClothes | 문자열의 배열 | 모든 Xbox 아바타 아이템에 있어야 하는 의상 유형의 목록입니다. |
| xboxAvatarStores | 문자열의 배열 | 모든 Xbox 아바타 아이템이 속해야 하는 스토어의 목록입니다. |
| xboxGamePublisherBits | 문자열의 배열 | 모든 GameType 항목 또는 AppType 항목에 설정해야 하는 게임 배급업체 비트의 목록입니다. |
| xboxIsBrowsable | 부울 값 | true이면 실행 가능한 콘텐츠뿐 아니라 직접적으로 실행 가능하지 않은 전체 게임도 반환합니다. 기본값은 false입니다. |
| xboxHasChildMediaItemTypes | 문자열의 배열 | 게임의 미디어 그룹이 있는 반환된 항목은 전부 미디어 항목 유형이 제공된 값 중 하나인 하위가 있어야 합니다. |