보조 EDS API
콘텐츠에 대한 정보를 직접 제공하지는 않지만 서비스 사용 방법에 대한 일반 정보를 제공하거나 일반적인 UI 모델을 구동하는 데 도움이 되는 여러 EDS(Entertainment Discovery Services) API가 있습니다.보조 API
API 매개 변수 값
이 API는 서비스에 사용할 수 있는 매개 변수를 설명합니다. 지역화된 텍스트가 각 매개 변수에 첨부되기 때문에 반환된 정보는 클라이언트 UI에서 사용할 수 있습니다. 아래 API 중 어느 것도 쿼리 매개 변수를 허용하지 않습니다. | API| URI| 설명| | --- | --- | --- | --- | --- | --- | | 유형| //metadata/mediaGroups| 미디어 그룹의 전체 목록| | 미디어 그룹당 미디어 항목 유형| //metadata/mediaGroups//mediaItemTypes| 지정된 미디어 그룹에 포함된 미디어 항목 유형 목록입니다.| | 모든 미디어 항목 유형| //metadata/mediaItemTypes| 미디어 항목 유형의 전체 목록| | 미디어 항목 유형당 필드| //metadata/mediaItemTypes//fields| 단일 미디어 항목 유형의 필드 목록| | 쿼리 조건자| //metadata/mediaItemTypes//queryRefiners| 지정된 미디어 항목 유형에 대해 지원되는 쿼리 조건자 목록| | 모든 쿼리 조건자 값| //metadata/mediaItemTypes//queryRefiners/| 지정된 미디어 항목 유형에 대한 지정된 쿼리 조건자의 값| | 모든 쿼리 조건자 하위 값| //metadata/mediaItemTypes//queryRefiners//subQueryRefinerValues| 지정된 쿼리 조건자 값에 대한 하위 값 목록입니다(예: “지정된 장르의 하위 장르”). 쿼리 조건자 값은 “queryRefinerValue”라는 이름의 쿼리 문자열 매개 변수로 전달되며, 이는 URI 스템에서 금지된 문자를 포함하는 쿼리 조건자 값을 전달할 수 있도록 하기 위해 수행됩니다.| | 정렬| //metadata/mediaItemTypes//sortOrders| 지정된 미디어 항목 유형에 대한 정렬 순서 목록|결합된 콘텐츠 등급 생성기
자녀가 볼 수 있는 콘텐츠에 대해 자녀 보호를 시행하는 것은 복잡한 작업입니다. 각 미디어 항목 유형에 자체 등급 시스템이 있을 뿐만 아니라 이러한 등급 시스템은 국가/지역마다 다를 수 있습니다. 즉, 모든 항목을 제대로 필터링하려면 지정해야 하는 여러 데이터가 있습니다. 이 API는 모든 API 호출에서 모든 매개 변수를 지정하는 대신, 다른 API의 combinedContentRating 매개 변수에 전달할 값을 생성하고 여전히 동일한 정보를 전달합니다. 이는 이 API에 전달된 여러 매개 변수가 다른 API용 단일 재사용 가능 값으로 축소되므로 API를 더 쉽게 사용하고 유지 관리할 수 있도록 설계되었습니다. 이 API에서 반환하는 정확한 값은 결국 변경될 수 있지만, 매우 드물게(예: EDS 릴리스 간에) 변경되어야 하므로 오랜 기간 동안 캐시될 수 있습니다. combinedContentRating 매개 변수를 수락하는 모든 API는 전달된 값이 유효하지 않은 경우 의미 있는 오류 메시지를 제공하며, 이는 호출자가 업데이트된 값을 얻기 위해 이 API를 다시 호출하기만 하면 된다는 표시입니다. API가 combinedContentRating 매개 변수를 수락하지만 하나도 제공되지 않은 경우, 자녀 보호에 따라 콘텐츠 필터링이 수행되지 않습니다.참고:
이는 “안전한” 콘텐츠만 반환된다는 의미가 아닙니다. 잠재적으로 노골적인 콘텐츠를 포함하여 모든 콘텐츠가 반환된다는 의미입니다.
결합된 필드 이름
EDS API는 기본적으로 각 항목에 대해 매우 작은 최소한의 필드 세트를 반환합니다.- 미디어 항목 유형
- 미디어 그룹
- Id
- Name