GET(/media/{marketplaceId}/contentRating)

아티클
05/09/2023

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

비고
URI 매개 변수
쿼리 문자열 매개 변수

설명

자녀가 볼 수 있는 콘텐츠에 대한 자녀 보호 기능을 적용하는 것은 복잡한 작업입니다. 각 미디어 항목 유형에는 자체 등급 시스템이 있으며, 해당 등급 시스템은 국가/지역마다 다를 수 있습니다. 즉, 모든 항목을 적절하게 필터링하기 위해 지정해야 하는 몇 가지 데이터가 있습니다.

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

이 API가 반환한 정확한 값은 변경될 수 있지만, 이러한 변경은 매우 드물게 발생하므로(예: 엔터테인먼트 검색 서비스(EDS)의 릴리스 사이) 장기간 동안 캐시될 수 있습니다. 전달된 값이 유효하지 않은 경우 combinedContentRating 매개 변수를 허용하는 API는 유의미한 오류 메시지를 제공하며, 이 메시지는 호출자가 업데이트된 값을 얻으려면 다시 이 API를 호출해야 한다는 의미를 나타냅니다. API가 combinedContentRating 매개 변수를 허용하지만 아무 것도 제공하지 않는 경우 자녀 보호 기능에 따라 콘텐츠 필터링이 수행되지 않습니다.

참고:
이는 "안전한" 콘텐츠만 반환된다는 의미는 아니며, 성인 등급 콘텐츠를 포함할 수 있는 모든 콘텐츠가 반환되었음을 의미합니다.

URI 매개 변수

매개 변수	형식	설명
marketplaceId	문자열	필수. Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId에서 획득한 문자열 값입니다.

쿼리 문자열 매개 변수

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