Skip to main content

GET (/media//contentRating)

콘텐츠 등급 토큰을 가져옵니다. 이 URI의 도메인은 eds.xboxlive.com입니다.

설명

자녀가 볼 수 있는 콘텐츠에 대해 자녀 보호를 시행하는 것은 복잡한 작업입니다. 각 미디어 항목 유형에는 자체 등급 시스템이 있을 뿐만 아니라 이러한 등급 시스템은 국가/지역마다 다를 수 있습니다. 이는 모든 항목을 적절히 필터링하기 위해 지정해야 하는 데이터가 여러 가지 있음을 의미합니다. 이 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//contentRating
추가 정보
EDS Common Headers EDS Parameters EDS Query Refiners Marketplace URIs 추가 참조
Last modified on October 19, 2026