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

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

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

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

* [備註](#ID4EV)
* [URI 參數](#ID4ELB)
* [查詢字串參數](#ID4EWB)

## 備註

針對允許兒童觀看的內容強制執行家長監護是一項複雜的工作。不僅每種媒體項目類型都有自己的分級制度，而且這些分級制度可能因國家/地區而異。這表示必須指定數項不同的資料，才能正確篩選所有項目。

此 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/{marketplaceId}/contentRating](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalecontentrating.md)

### 進一步資訊

[EDS 通用標頭](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edscommonheaders.md)

[EDS 參數](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsparameters.md)

[EDS 查詢精簡器](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsqueryrefiners.md)

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

[其他參考](https://docs.xbox.com/zh-TW/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [/media/{marketplaceId}/contentRating](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalecontentrating.md)
- [GET (media/{marketplaceId}/browse)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalebrowseget.md)
- [GET (media/{marketplaceId}/singleMediaGroupSearch)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalesinglemediagroupsearchget.md)
- [GET (/media/{marketplaceId}/details)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocaledetailsget.md)
- [GET (/media/{marketplaceId}/fields)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalefieldsget.md)