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

## 설명

자녀가 볼 수 있는 콘텐츠에 대해 자녀 보호를 시행하는 것은 복잡한 작업입니다. 각 미디어 항목 유형에는 자체 등급 시스템이 있을 뿐만 아니라 이러한 등급 시스템은 국가/지역마다 다를 수 있습니다. 이는 모든 항목을 적절히 필터링하기 위해 지정해야 하는 데이터가 여러 가지 있음을 의미합니다.

이 API는 모든 API 호출에서 모든 매개변수를 지정하는 대신, 다른 API에서 **combinedContentRating** 매개변수에 전달할 값을 생성하고 동일한 정보를 전달합니다. 이는 이 API에 전달된 여러 매개변수가 다른 API에 대한 재사용 가능한 단일 값으로 축소되므로 API를 더 쉽게 사용하고 유지 관리할 수 있도록 설계되었습니다.

이 API에서 반환되는 정확한 값은 결국 변경될 수 있지만, 매우 드물게(예: Entertainment Discovery Services(EDS) 릴리스 사이에) 변경되므로 오랜 기간 캐시될 수 있습니다. **combinedContentRating** 매개변수를 허용하는 모든 API는 전달된 값이 유효하지 않은 경우 의미 있는 오류 메시지를 제공하며, 이는 호출자가 이 API를 다시 호출하여 업데이트된 값을 얻어야 함을 나타냅니다. API가 **combinedContentRating** 매개변수를 허용하지만 제공되지 않으면 보호자 통제에 기반한 콘텐츠 필터링이 수행되지 않습니다.

> **참고:**\
> 이는 "안전한" 콘텐츠만 반환된다는 의미가 아닙니다. 잠재적으로 노골적인 콘텐츠를 포함한 모든 콘텐츠가 반환됨을 의미합니다.

## URI 매개변수

\| 매개변수| 형식| 설명|
\| --- | --- | --- | --- |
\| marketplaceId| string| 필수. **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId**에서 얻은 문자열 값입니다.|

## 쿼리 문자열 매개변수

\| 매개변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- |
\| filterExplicit| Boolean 값| 선택 사항. 노골적인 음악을 필터링합니다.|
\| filterFamilyOnlyApps| Boolean 값| 선택 사항. 가족 친화적으로 표시되지 않은 앱을 필터링합니다.|
\| filterUnrated| Boolean 값| 선택 사항. 등급이 매겨지지 않은 콘텐츠를 응답에 포함할지 여부를 결정합니다.|
\| maxGameRating| 32비트 부호 있는 정수| 선택 사항. 게임을 필터링합니다.|
\| maxMovieRating| 32비트 부호 있는 정수| 선택 사항. 특정 수준 이상의 영화를 필터링합니다.|
\| maxTVRating| 32비트 부호 있는 정수| 선택 사항. TV를 필터링합니다.|

## 참고 항목

##### 상위 항목

[/media/{marketplaceId}/contentRating](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-medialocalecontentrating)

##### 추가 정보

[EDS Common Headers](https://devdocs.xbox.com/ko/reference/live/rest/additional/edscommonheaders)

[EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters)

[EDS Query Refiners](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[추가 참조](https://devdocs.xbox.com/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Economy v2 Catalog Content Types, Tags, & Properties](https://devdocs.xbox.com/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Age ratings](https://devdocs.xbox.com/publishing/game-publishing/concepts/age-ratings.md)
- [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](https://devdocs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](https://devdocs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)