Skip to main content

GET (/media//contentRating)

取得內容分級權杖。 這些 URI 的網域是 eds.xboxlive.com。

備註

針對允許兒童觀看的內容強制執行家長監護是一項複雜的工作。不僅每種媒體項目類型都有自己的分級制度,而且這些分級制度可能因國家/地區而異。這表示必須指定數項不同的資料,才能正確篩選所有項目。 此 API 會產生一個值,以傳遞至其他 API 中的 combinedContentRating 參數,而不必在所有 API 呼叫中指定所有參數,同時仍能傳達相同的資訊。這樣的設計可讓 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//contentRating
進一步資訊
EDS 通用標頭 EDS 參數 EDS 查詢精簡器 Marketplace URI 其他參考
Last modified on October 6, 2026