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

# EDS Query Refiners

> EDS Query Refiners

# EDS 查询精简器

以下参数可用于将娱乐发现服务 (EDS) 查询精简为更有针对性的项集。这些参数在任何 API 中都不是必需的，但在接受查询精简器的任何 API 中都会被接受。

参数名可以作为值传入任何 "queryRefiners" 参数中。这样将返回如果用该查询精简器重复请求会返回的项数，并按该查询精简器的每个取值进行细分。

以下是在实践中的一种可能工作方式：

* 对 browse API 发起一次调用，包含参数 "queryRefiners=genre"。
* 该 API 返回八款游戏。除项目之外，还会返回具有项目的每个流派的列表，以及每个流派中包含多少项。对于游戏而言，可能是 "Shooter: 3, Puzzle: 5"。
* 发起第二次查询。它与第一次相同，只是增加了 "genre=Shooter"。
* 响应现在只包含三款游戏，它们都属于 "Shooter" 类别。

| 参数 | 数据类型 | 说明 |
| - | - | - |
| **decade** | string | 所有项必须发行所在的年代。 |
| **genre** | array of string | 所有项必须具有的流派列表。 |
| **labelOwner** | string | 与艺术家、专辑或曲目关联的唱片公司。 |
| **network** | array of string | 创作这些项的电视网。 |
| **studio** | array of string | 创作这些项的工作室。 |
| **xboxAppCategories** | array of string | 所有 XBOX 应用必须具有的类别列表。 |
| **xboxAvatarClothes** | array of string | 所有 XBOX 头像项必须具有的服装类型列表。 |
| **xboxAvatarStores** | array of string | 所有 XBOX 头像项必须归属的商店列表。 |
| **xboxGamePublisherBits** | array of string | 所有 GameType 项或 AppType 项上必须设置的游戏发行商位列表。 |
| **xboxIsBrowsable** | Boolean 值 | 如果为 **true**，除可直接操作的内容外，还将返回不可直接操作的完整游戏。默认为 **false**。 |
| **xboxHasChildMediaItemTypes** | array of string | 所有媒体组为 Game 的返回项，其子项的媒体项类型必须为所提供值中的一个。 |

## 另请参阅

##### 上级

[附加参考](https://docs.xbox.com/zh-CN/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)

##### 更多信息

[市场 URI](https://docs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)


## Related topics

- [GET (/media/{marketplaceId}/metadata/mediaItemTypes/{mediaitemtype}/queryrefiners/{queryRefiner}/subQueryRefinerValues)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalemediaitemtypequeryrefinersubqueryrefinervaluesget.md)
- [/media/{marketplaceId}/metadata/mediaItemTypes/{mediaitemtype}/queryrefiners/{queryRefiner}/subQueryRefinerValues](https://docs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalemediaitemtypequeryrefinersubqueryrefinervalues.md)
- [Auxiliary EDS APIs](https://docs.xbox.com/zh-CN/reference/live/rest/additional/eds-apis.md)
- [GET (media/{marketplaceId}/singleMediaGroupSearch)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalesinglemediagroupsearchget.md)
- [GET (media/{marketplaceId}/browse)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalebrowseget.md)