> ## 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.

# GET (/media/{marketplaceId}/contentRating)

> GET (/media/{marketplaceId}/contentRating)

# GET (/media/{marketplaceId}/contentRating)

获取内容分级令牌。
这些 URI 的域为 `eds.xboxlive.com`。

* [备注](#ID4EV)
* [URI 参数](#ID4ELB)
* [查询字符串参数](#ID4EWB)

## 备注

对儿童能够查看的内容强制实施家长控制是一项复杂的任务。不仅每种媒体项类型都有各自的分级系统,而且这些分级系统在不同国家/地区之间也可能各不相同。这意味着需要指定多项不同的数据才能正确筛选所有项。

此 API 不需要在所有 API 调用中都指定所有参数,而是生成一个值,用于传入其他 API 的 **combinedContentRating** 参数,同时仍然传达相同的信息。这样设计旨在使 API 更易于使用和维护,因为传入此 API 的多个参数被折叠成一个可为其他 API 重复使用的单一值。

虽然此 API 返回的确切值最终可能会更改,但它们的变化应该非常少(例如仅在 Entertainment Discovery Services (EDS) 各版本发布之间),因此可以长期缓存。任何接受 **combinedContentRating** 参数的 API 在传入的值无效时都会给出有意义的错误消息,这表明调用者只需再次调用此 API 即可获取更新后的值。如果某个 API 接受 **combinedContentRating** 参数,但未提供该参数,则不会根据家长控制对内容进行任何筛选。

> **注意:**\
> 这并不意味着仅返回“安全”内容——而是意味着将返回所有内容,包括可能的不良内容。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| marketplaceId | string | 必需。从 **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId** 获取的字符串值。 |

## 查询字符串参数

| 参数 | 类型 | 说明 |
| - | - | - |
| filterExplicit | 布尔值 | 可选。筛选不良音乐。 |
| filterFamilyOnlyApps | 布尔值 | 可选。筛选未标记为“家庭友好”的应用。 |
| filterUnrated | 布尔值 | 可选。确定响应中是否应包含未分级的内容。 |
| maxGameRating | 32 位有符号整数 | 可选。筛选游戏。 |
| maxMovieRating | 32 位有符号整数 | 可选。筛选高于特定级别的电影。 |
| maxTVRating | 32 位有符号整数 | 可选。筛选电视节目。 |

## 另请参阅

##### 父主题

[/media/{marketplaceId}/contentRating](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalecontentrating)

##### 更多信息

[EDS 通用标头](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edscommonheaders)

[EDS 参数](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsparameters)

[EDS 查询精简器](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URIs](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[其他参考](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Economy v2 Catalog Content Types, Tags, & Properties](https://devdocs.xbox.com/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Age ratings](https://devdocs.xbox.com/publishing/game-publishing/concepts/age-ratings.md)
- [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](https://devdocs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](https://devdocs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)