EDS 매개 변수
쿼리 문자열 매개 변수
이러한 쿼리 매개 변수가 모든 EDS(Entertainment Discovery Services) API에서 반드시 수락되는 것은 아니지만, 모두 두 개 이상의 API에서 수락됩니다.| 매개 변수 | 형식 | 설명 |
|---|---|---|
| combinedContentRating | string | 선택 사항. GET (/media//contentRating)을 참조하세요. |
| continuationToken | string | 선택 사항. 연속 토큰은 특정 시나리오에서 페이지 매김을 위해 서비스에서 필요한 정보를 포함하는 불투명한 blob입니다. 값을 생략하면 결과의 첫 페이지가 반환되며(페이지 크기는 maxItems 매개 변수로 결정됨), 결과의 두 번째 페이지를 얻는 데 사용할 수 있는 연속 토큰이 함께 반환됩니다. 두 번째 페이지에는 결과의 세 번째 페이지에 대한 연속 토큰이 포함되고, 이런 식으로 계속됩니다. |
| Desired | string | 선택 사항. 결합된 필드 이름 API를 참조하세요. |
| desiredMediaItemTypes | string 배열 | 선택 사항. 이 매개 변수는 응답에서 반환할 항목 유형을 결정합니다. |
| Domain | string | 선택 사항. Domain 매개 변수는 클라이언트가 호출하는 게임 및 앱 마켓플레이스 컨텍스트를 결정합니다. 기본적으로 도메인은 “Modern”이며, 클라이언트가 XBOX One(또는 그 이후) 콘텐츠만 요청할 수 있음을 나타냅니다. 클라이언트가 도메인을 전환하여 XBOX 360 콘텐츠를 표시하려는 경우 도메인을 “Xbox360”으로 지정해야 합니다. 현재 교차 도메인 결과는 지원되지 않습니다. 가능한 값은 다음과 같습니다:
|
| fields | string | 선택 사항. GET (/media//fields)을 참조하세요. |
| firstPartyOnly | 부울 값 | 선택적 필터 매개 변수. 쿼리에서 자사 콘텐츠만 반환되는지 또는 자사 및 타사 콘텐츠 모두 반환되는지 여부를 결정합니다. |
| freeOnly | 부울 값 | 선택적 필터 매개 변수. 결과를 무료 콘텐츠로만 제한합니다. |
| GroupBy | TK | groupBy 매개 변수는 결과 세트를 단일 결과 세트가 아닌 그룹으로 분류하는 데 도움이 됩니다. 이 매개 변수를 지정하면 여러 항목 목록을 반환하도록 결과 세트가 수정되며, 각 버킷의 항목 수는 maxItems 매개 변수로 결정됩니다.
|
| hasTrailer | 부울 값 | 선택적 필터 매개 변수. 반환된 항목에 예고편이 포함되어야 하는지 아니면 예고편을 포함하는 것이 선택 사항인지 여부를 결정합니다. 값이 true이면 모든 항목에 예고편이 있어야 합니다. |
| id | string | 선택 사항. 제공된 경우 결과를 지정된 ID를 가진 항목의 자식으로만 제한합니다. 이 매개 변수가 제공되면 MediaItemType도 지정해야 합니다. |
| ids | string 배열 | 필수. 세부 정보를 반환할 모든 ID(최대 10개)입니다. URL에 넣을 수 없는 문자를 포함하는 모든 ID(ProviderContentId 유형 ID는 일반적으로 전체 URL 자체이므로 잘못된 문자를 포함함)는 EDS에 올바르게 전송하려면 URL로 인코딩해야 합니다. |
| idType | string | 선택 사항. ids 매개 변수에 전달된 ID의 유형입니다. 유효한 값에는 다음이 포함됩니다:
|
| latestOnly | 부울 값 | 선택적 필터 매개 변수. 결과를 가장 최근 릴리스 날짜의 콘텐츠로만 제한합니다. |
| maxItems | 32비트 부호 있는 정수 | 선택 사항. 호출에서 반환해야 하는 최대 항목 수를 결정합니다. 유효한 값은 1과 25 사이의 숫자입니다(포함). 생략하면 매개 변수의 기본값은 25입니다. |
| mediaGroup | string | 선택 사항. ID의 미디어 그룹입니다. 제공된 모든 ID는 동일한 미디어 그룹을 공유해야 합니다. |
| MediaItemType | string | 선택 사항. id 매개 변수에 지정된 ID를 가진 항목의 유형입니다. id 매개 변수가 제공된 경우 이 매개 변수도 지정해야 합니다. |
| orderBy | string | 필수. orderBy 매개 변수는 반환되는 항목을 정렬하는 방법을 결정합니다. 이 필드의 일반적인 값이 여기에 나열되어 있지만 일부 API는 추가 값을 지원할 수 있습니다.
|
| preferredProvider | string | 선택 사항. 사용자가 Comcast Xfinity 또는 Verizon FIOS와 같은 기본 콘텐츠 공급자를 가지고 있다면 해당 공급자의 ID를 전달할 수 있습니다. 항목의 실제 순서는 변경되지 않지만, 각 항목에 대해 지정된 공급자의 정보가 공급자 목록의 상단에 표시됩니다(기본 콘텐츠 공급자가 항목을 사용할 수 있는 경우). |
| q | string | 필수. 검색에 사용되는 쿼리 용어입니다. |
| queryRefiners | string 배열 | 선택 사항. EDS 쿼리 조건자 목록을 참조하세요. |
| relationship | string | 선택 사항. 지정된 관계 유형과 일치하는 다른 제품을 검색하기 위해 ID 매개 변수를 기준으로 사용하는 필터:
|
| ScopeId | string | 이 매개 변수는 비디오 미디어에 대한 역방향 조회 시나리오에서 사용됩니다. |
| ScopeIdType | string | 이 매개 변수는 비디오 미디어에 대한 역방향 조회 시나리오에서 사용됩니다. 가능한 값: Title. |
| skipItems | 32비트 부호 있는 정수 | 선택 사항. 교차 그룹이 아닌 시나리오에서 페이징을 위해 skipItems 매개 변수는 이미 몇 개의 항목이 표시되었는지(따라서 결과 세트에 어떤 항목이 먼저 표시되어야 하는지)를 결정하는 데 사용됩니다. 값은 0부터 시작하므로 skipItems=0(또는 단순히 skipItems를 제공하지 않음)은 목록의 시작 부분에서 검색을 시작합니다. skipItems=3은 목록의 처음 세 항목을 건너뛰고 네 번째 항목부터 검색을 시작합니다. |
| subscriptionLevel | string 배열 | 선택적 필터 매개 변수. subscriptionLevel 매개 변수는 사용자가 가진 구독 유형을 결정합니다(예: 사용자가 유료 구독을 가지고 있는지 또는 무료 구독을 가지고 있는지). 가능한 값은 다음과 같습니다.
|
| TargetDevices | string | EDS는 대상 장치에 대한 오퍼를 필터링할 수 있는 유연성을 제공합니다. 항목에 대해 반환된 오퍼(ProviderContent 또는 Availability)는 대상 장치로 제한될 수 있습니다. |
| topRatedOnly | 부울 값 | 선택적 필터 매개 변수. 결과를 가장 잘 평가된 콘텐츠로만 제한합니다. |