> ## 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. # EDS 매개 변수 > EDS Parameters # EDS 매개 변수 ## 쿼리 문자열 매개 변수 이러한 쿼리 매개 변수가 모든 [EDS(Entertainment Discovery Services) API](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace)에서 반드시 수락되는 것은 아니지만, 모두 두 개 이상의 API에서 수락됩니다. | 매개 변수 | 형식 | 설명 | | - | - | - | | combinedContentRating | string | 선택 사항. [GET (/media/{marketplaceId}/contentRating)](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-medialocalecontentratingget)을 참조하세요. | | continuationToken | string | 선택 사항. 연속 토큰은 특정 시나리오에서 페이지 매김을 위해 서비스에서 필요한 정보를 포함하는 불투명한 blob입니다. 값을 생략하면 결과의 첫 페이지가 반환되며(페이지 크기는 maxItems 매개 변수로 결정됨), 결과의 두 번째 페이지를 얻는 데 사용할 수 있는 연속 토큰이 함께 반환됩니다. 두 번째 페이지에는 결과의 세 번째 페이지에 대한 연속 토큰이 포함되고, 이런 식으로 계속됩니다. | | Desired | string | 선택 사항. 결합된 필드 이름 API를 참조하세요. | | desiredMediaItemTypes | string 배열 | 선택 사항. 이 매개 변수는 응답에서 반환할 항목 유형을 결정합니다. | | Domain | string | 선택 사항. Domain 매개 변수는 클라이언트가 호출하는 게임 및 앱 마켓플레이스 컨텍스트를 결정합니다. 기본적으로 도메인은 "Modern"이며, 클라이언트가 XBOX One(또는 그 이후) 콘텐츠만 요청할 수 있음을 나타냅니다. 클라이언트가 도메인을 전환하여 XBOX 360 콘텐츠를 표시하려는 경우 도메인을 "Xbox360"으로 지정해야 합니다. 현재 교차 도메인 결과는 지원되지 않습니다. 가능한 값은 다음과 같습니다: "Xbox360" 값은 singleMediaGroupSearch에만 지원됩니다. Browse 및 Details가 지원됩니다. crossMediaGroupSearch는 지원되지 않으며 400 오류를 반환합니다. | | fields | string | 선택 사항. [GET (/media/{marketplaceId}/fields)](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-medialocalefieldsget)을 참조하세요. | | 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의 유형입니다. 유효한 값에는 다음이 포함됩니다: 제공된 모든 ID는 동일한 idType을 공유해야 합니다. 이 값이 생략되면 모든 ID는 Canonical로 간주됩니다. | | 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 쿼리 조건자](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners) 목록을 참조하세요. | | 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 | 부울 값 | 선택적 필터 매개 변수. 결과를 가장 잘 평가된 콘텐츠로만 제한합니다. | ## 함께 보기 ### 상위 [추가 참조](https://devdocs.xbox.com/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional) ### 추가 정보 [Marketplace URI](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace) ## Related topics - [GameInput의 포스 피드백](https://devdocs.xbox.com/ko/build/core-features/common/input/advanced/input-forcefeedback.md) - [EnumerateMetaCommandParameters (XBOX Series 콘솔)](https://devdocs.xbox.com/ko/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommandparameters_public.md) - [이벤트 기반 통계 규칙 개요](https://devdocs.xbox.com/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md) - [XUserGetTokenAndSignatureResult](https://devdocs.xbox.com/ko/reference/system/xuser/functions/xusergettokenandsignatureresult.md) - [XUserGetTokenAndSignatureUtf16Result](https://devdocs.xbox.com/ko/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)