获取 (/media/{marketplaceId}/contentRating)
获取内容分级令牌。
这些 URI 的域是 eds.xboxlive.com。
备注
对允许孩子看到的内容执行家长控制是一项复杂的任务。 不仅每个媒体项类型都有自己的分级系统，而且这些分级系统可能因国家/地区和国家/地区而异。 这意味着，有几个不同的数据片段需要指定，以正确筛选所有项目。
不是在所有 API 调用中指定所有参数，此 API 将生成传入其他 API 中的 combinedContentRating 参数的值，而且仍然传送相同信息。 这是为了让 API 更方便使用和维护，因为传入此 API 的几个参数将折叠为其他 API 的一个可重用的值。
虽然此 API 返回的精确值最终可能会更改，但更改应该不会非常频繁（如两次 Entertainment Discovery Services (EDS) 发布之间），因此可以在很长一段时间内缓存。 如果传入的值无效，接受 combinedContentRating 参数的任何 API 都将给出一条有意义的错误消息，这指示调用方只需要再次调用此 API 来获取更新值。 如果 API 接受 combinedContentRating 参数，但未提供此参数，则不会根据家长控制筛选内容。
注意：
这并不意味着只返回“安全”内容，而是意味着将返回所有内容，包括潜在的色情内容。
URI 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| marketplaceId | 字符串 | 必需。 从 Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId 获取的字符串值。 |
查询字符串参数
| 参数 | 类型 | 说明 |
|---|---|---|
| filterExplicit | 布尔值 | 可选。 筛选成人音乐。 |
| filterFamilyOnlyApps | 布尔值 | 可选。 筛选未标记为家庭友好的应用。 |
| filterUnrated | 布尔值 | 可选。 确定未分级内容是否应包含在响应中。 |
| maxGameRating | 32 位有符号整数 | 可选。 筛选游戏。 |
| maxMovieRating | 32 位有符号整数 | 可选。 筛选特定级别以上的电影。 |
| maxTVRating | 32 位有符号整数 | 可选。 筛选电视。 |
另请参阅
父级
/media/{marketplaceId}/contentRating