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

<a id="ID4EV" />

## 備註

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

此 API 會產生一個值，以傳遞至其他 API 中的 **combinedContentRating** 參數，而不必在所有 API 呼叫中指定所有參數，同時仍能傳達相同的資訊。這樣的設計可讓 API 更容易使用和維護，因為傳遞至此 API 的數個參數會合併成一個可供其他 API 重複使用的單一值。

雖然此 API 傳回的確切值最終可能會變更，但變更頻率應該非常低 (例如在 Entertainment Discovery Services (EDS) 的版本之間)，因此可以長時間快取。如果傳入的值無效，任何接受 **combinedContentRating** 參數的 API 都會提供有意義的錯誤訊息，這表示呼叫者只需要再次呼叫此 API 以取得更新的值。如果 API 接受 **combinedContentRating** 參數但未提供該參數，則不會根據家長監護篩選內容。

> **注意：**\
> 這並不表示只會傳回「安全」的內容，而是表示會傳回所有內容，包括可能含有露骨內容的項目。

<a id="ID4ELB" />

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| marketplaceId| string| 必要。從 <b>Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId</b> 取得的字串值。|

<a id="ID4EWB" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- |
\| filterExplicit| 布林值| 選用。篩選含有露骨內容的音樂。|
\| filterFamilyOnlyApps| 布林值| 選用。篩選未標示為適合闔家使用的應用程式。|
\| filterUnrated| 布林值| 選用。決定是否要在回應中包含未分級的內容。|
\| maxGameRating| 32 位元帶正負號整數| 選用。篩選遊戲。|
\| maxMovieRating| 32 位元帶正負號整數| 選用。篩選高於特定等級的電影。|
\| maxTVRating| 32 位元帶正負號整數| 選用。篩選電視節目。|

<a id="ID4E5D" />

## 另請參閱

<a id="ID4EAE" />

##### 上層

[/media/{marketplaceId}/contentRating](/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalecontentrating)

<a id="ID4EKE" />

##### 進一步資訊

[EDS 通用標頭](/zh-TW/reference/live/rest/additional/edscommonheaders)

[EDS 參數](/zh-TW/reference/live/rest/additional/edsparameters)

[EDS 查詢精簡器](/zh-TW/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URI](/zh-TW/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[其他參考](/zh-TW/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Age ratings](/publishing/game-publishing/concepts/age-ratings.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Age ratings guidance for countries/regions](/publishing/game-publishing/concepts/age-ratings-guidance.md)