GET (/media//contentRating)
获取内容分级令牌。 这些 URI 的域为eds.xboxlive.com。
备注
对儿童能够查看的内容强制实施家长控制是一项复杂的任务。不仅每种媒体项类型都有各自的分级系统,而且这些分级系统在不同国家/地区之间也可能各不相同。这意味着需要指定多项不同的数据才能正确筛选所有项。 此 API 不需要在所有 API 调用中都指定所有参数,而是生成一个值,用于传入其他 API 的 combinedContentRating 参数,同时仍然传达相同的信息。这样设计旨在使 API 更易于使用和维护,因为传入此 API 的多个参数被折叠成一个可为其他 API 重复使用的单一值。 虽然此 API 返回的确切值最终可能会更改,但它们的变化应该非常少(例如仅在 Entertainment Discovery Services (EDS) 各版本发布之间),因此可以长期缓存。任何接受 combinedContentRating 参数的 API 在传入的值无效时都会给出有意义的错误消息,这表明调用者只需再次调用此 API 即可获取更新后的值。如果某个 API 接受 combinedContentRating 参数,但未提供该参数,则不会根据家长控制对内容进行任何筛选。注意:
这并不意味着仅返回“安全”内容——而是意味着将返回所有内容,包括可能的不良内容。