> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EDS 쿼리 구체화

> EDS Query Refiners

# EDS 쿼리 조건자

다음 매개 변수를 사용하여 EDS(Entertainment Discovery Services) 쿼리를 보다 표적화된 항목 집합으로 세분화할 수 있습니다. 이러한 매개 변수는 어느 API에서도 필수가 아니지만, 쿼리 조건자를 수락하는 모든 API에서 수락됩니다.

매개 변수 이름은 "queryRefiners" 매개 변수에 값으로 전달할 수 있습니다. 그러면 요청이 쿼리 조건자를 적용하여 반복될 경우 반환될 항목 수가 반환되며, 쿼리 조건자의 각 값별로 세분화됩니다.

실제 작동 방식은 다음과 같습니다:

* "queryRefiners=genre" 매개 변수를 포함하여 찾아보기 API를 호출합니다.
* API가 8개의 게임을 반환합니다. 항목 외에도 항목이 있는 각 장르 목록이 해당 장르에 속한 항목 수와 함께 반환됩니다. 게임의 경우 "Shooter: 3, Puzzle: 5"일 수 있습니다.
* 두 번째 쿼리가 이루어집니다. 첫 번째와 동일하지만 "genre=Shooter"가 추가됩니다.
* 이제 응답에는 세 개의 게임만 포함되며, 모두 "Shooter" 카테고리에 속합니다.

| 매개 변수 | 데이터 형식 | 설명 |
| - | - | - |
| **decade** | string | 모든 항목이 릴리스되어야 하는 연대(decade)입니다. |
| **genre** | string 배열 | 모든 항목이 가져야 하는 장르 목록입니다. |
| **labelOwner** | string | 아티스트, 앨범 또는 트랙과 연결된 음악 레이블입니다. |
| **network** | string 배열 | 항목을 만든 네트워크입니다. |
| **studio** | string 배열 | 항목을 만든 스튜디오입니다. |
| **xboxAppCategories** | string 배열 | 모든 XBOX 앱이 가져야 하는 카테고리 목록입니다. |
| **xboxAvatarClothes** | string 배열 | 모든 XBOX Avatar 항목이 가져야 하는 의류 유형 목록입니다. |
| **xboxAvatarStores** | string 배열 | 모든 XBOX 아바타 항목이 속해야 하는 스토어 목록입니다. |
| **xboxGamePublisherBits** | string 배열 | 모든 GameType 항목 또는 AppType 항목에 설정되어야 하는 게임 게시자 비트 목록입니다. |
| **xboxIsBrowsable** | 부울 값 | **true**이면 실행 가능한 콘텐츠 외에도 직접 실행할 수 없는 전체 게임을 반환합니다. 기본값은 **false**입니다. |
| **xboxHasChildMediaItemTypes** | string 배열 | 미디어 그룹이 Game인 반환된 모든 항목에는 미디어 항목 유형이 제공된 값 중 하나인 자식이 있어야 합니다. |

## 함께 보기

##### 상위

[추가 참조](/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional)

##### 추가 정보

[Marketplace URI](/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace)


## Related topics

- [검색 가능한 로비 만들기](/ko/services/playfab/multiplayer/lobby/define-search-keywords.md)
- [서비스에서 사용자 사용 권한 쿼리](/ko/publishing/xstore-commerce/xstore-query-entitlements.md)
- [XBOX Partner Onboarding for access and publishing](/home/onboarding.md)
- [Integração de Parceiro XBOX para acesso e publicação](/pt-BR/home/onboarding.md)
- [Incorporación de partners de XBOX para acceso y publicación](/es/home/onboarding.md)