> ## 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. # GET (media/{marketplaceId}/singleMediaGroupSearch) > GET (media/{marketplaceId}/singleMediaGroupSearch) # GET (media/{marketplaceId}/singleMediaGroupSearch) 단일 미디어 그룹 내에서 항목 검색을 허용합니다. 이러한 URI의 도메인은 `eds.xboxlive.com`입니다. * [설명](#ID4EV) * [URI 매개 변수](#ID4EEB) * [쿼리 문자열 매개 변수](#ID4EPB) * [응답 본문](#ID4E5B) ## 설명 이 검색에서 반환된 데이터 페이지는 계속 토큰(continuation token)을 사용하는 대신 skipItems 매개 변수를 사용하여 비순차적으로 액세스할 수 있습니다. 이 API는 쿼리 조율자(Query Refiners)를 허용합니다. **SandboxId**는 이제 XToken의 클레임에서 검색되어 적용됩니다. **SandboxId**가 존재하지 않는 경우 Entertainment Discovery Services(EDS)는 400 Bad request 오류를 발생시킵니다. ## URI 매개 변수 | 매개 변수 | 형식 | 설명 | | - | - | - | | marketplaceId | string | 필수. **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId**에서 얻은 문자열 값입니다. | ## 쿼리 문자열 매개 변수 이 API는 다음의 쿼리 매개 변수를 허용합니다: combinedContentRating, desiredMediaItemTypes, fields, maxItems, preferredProvider, q, queryRefiners, skipItems, firstPartyOnly, freeOnly, hasTrailer, latestOnly, subscriptionLevel, topRatedOnly. 이러한 매개 변수에 대한 자세한 내용은 [EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters)를 참고하십시오. ## 응답 본문 ### 샘플 응답 아래 JSON 코드는 `/media/en-us/singleMediaGroupSearch?q=vector&desiredMediaItemTypes=DGame&fields=all` 호출에 대한 응답입니다. ```cpp theme={null} { "Items": [{ "MediaGroup": "GameType", "MediaItemType": "DGame", "ID": "fd16e2fb-eca4-4182-8f69-a98fdd6e57a1", "Name": "Vector based massively multiplayer Tanks game.", "ReducedName": "Tanks", "ReleaseDate": "2013-03-15T00: 00: 00Z", "TitleId": "69A60C76", "VuiDisplayName": "Tanks", "DeveloperName": "Microsoft Studios", "Images": [{ "ID": "32ebd9fe-6a22-4111-954e-564ec69d802a", "ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--", "Purposes": ["Box_Art"], "Purpose": "Box_Art", "Height": 300, "Width": 219, "Order": 1 }, { "ID": "32ebd9fe-6a22-4111-954e-564ec69d802a", "ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--", "Purposes": ["Box_Art"], "Purpose": "Box_Art", "Height": 120, "Width": 85, "Order": 1 }, { "ID": "32ebd9fe-6a22-4111-954e-564ec69d802a", "ResizeUrl": "http: //images-eds.dnet.xboxlive.com/image?url=RIJNAEIo6.u.tudW9rXJ2lWDOsMikqfNiHE2Sp4qbgNbH6_drY8Ek2cyHXEnnUKPUXAH_m8a3Oe4_wpV7CkKA0Snc9puIYOGxsIfyyncTBv.MIluDZX6UqAPsJYHE5go_J_BBfxNWW6yrK4.K75aMQ--", "Purposes": ["Image"], "Purpose": "Image", "Height": 720, "Width": 1280, "Order": 1 }], "PublisherName": "Microsoft Studios", "RatingId": "10", "ParentalRating": "E", "ParentalRatingSystem": "ESRB", "SortName": "\n Vector based massively multiplayer Tanks game.\n ", "Capabilities": [{ "NonLocalizedName": "onlineMultiplayerMin", "Value": "3" }, { "NonLocalizedName": "onelineMultiplayerMax", "Value": "5" }], "KValue": "4", "KValueNamespace": "bingbox", "AllTimePlayCount": 30.0, "SevenDaysPlayCount": 30.0, "ThirtyDaysPlayCount": 30.0, "AllTimeRatingCount": 12.0, "ThirtyDaysRatingCount": 12.0, "SevenDaysRatingCount": 12.0, "AllTimeAverageRating": 0.8, "ThirtyDaysAverageRating": 0.8, "SevenDaysAverageRating": 0.8, "LegacyIds": [{ "IdType": "TitleId", "Value": "69A60C76" }], "Availabilities": [{ "AvailabilityID": "", "ContentId": "7AE9DAB2-1162-488D-9F80-B804EC5AF879", "Devices": [{ "Name": "Durango" }] }], "Packages": [{ "CdnFileLocation": [{ "SortOrder": null, "Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc" }, { "SortOrder": null, "Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc" }, { "SortOrder": null, "Uri": "https: //update.dnet.xboxlive.com/test_cdn/tanks-randomkey.xvc" }], "ContentId": "7AE9DAB2-1162-488D-9F80-B804EC5AF879", "PackageType": "XVC", "LicenseType": "Xbox Live Games Machine and User" }], "SandboxId": "PART.Dev1" }], "ImpressionGuid": "840bae05-776e-4429-b522-e64543ac3a35" } ``` ## 참고 항목 ##### 상위 [/media/{marketplaceId}/singleMediaGroupSearch](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-medialocalesinglemediagroupsearch) ##### 추가 정보 [EDS Common Headers](https://devdocs.xbox.com/ko/reference/live/rest/additional/edscommonheaders) [EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters) [EDS Query Refiners](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners) [Marketplace URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace) [Additional Reference](https://devdocs.xbox.com/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional) ## Related topics - [Media validation test steps](https://devdocs.xbox.com/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md) - [XblPresenceMediaIdType](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/enums/xblpresencemediaidtype.md) - [Economy v2 Catalog Content Types, Tags, & Properties](https://devdocs.xbox.com/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md) - [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](https://devdocs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)