> ## 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}/crossMediaGroupSearch)

> GET (/media/{marketplaceId}/crossMediaGroupSearch)

# GET (/media/{marketplaceId}/crossMediaGroupSearch)

여러 다른 미디어 그룹의 항목을 가져옵니다.
이 URI의 도메인은 `eds.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개변수](#ID4EEB)
* [쿼리 문자열 매개변수](#ID4EPB)
* [응답 본문](#ID4ETC)

## 설명

cross-group API를 사용하면 클라이언트가 여러 다른 미디어 그룹의 항목을 검색할 수 있습니다. 이 API는 결과를 페이지 매기며 탐색하기 위해 정방향 전용 연속 토큰을 사용해야 합니다. 이 API는 쿼리 정련기(Query Refiners)를 허용합니다.

이제 **SandboxId**는 XToken의 클레임에서 검색되어 적용됩니다. **SandboxId**가 없으면 Entertainment Discovery Services(EDS)는 400 Bad request 오류를 발생시킵니다.

## URI 매개변수

| 매개변수 | 형식 | 설명 |
| - | - | - |
| marketplaceId | string | 필수. **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId**에서 얻은 문자열 값입니다. |

## 쿼리 문자열 매개변수

\| 매개변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- |
\| continuationToken| string| 선택 사항. ContinuationToken 매개변수를 참조하세요.|
\| q| string| 필수. 검색에 사용되는 쿼리 용어입니다.|

## 응답 본문

### 샘플 응답

아래의 JSON 코드는 `/media/en-us/crossMediaGroupSearch?q=vector&maxItems=25&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": "30",
        "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"
    },
    {
        "MediaGroup": "MusicArtistType",
        "MediaItemType": "MusicArtist",
        "ID": "61cdf888-7b2b-5111-82f4-87e9c7a86504",
        "Name": "Vector",
        "Genres": [{
            "Name": "Hip Hop"
        }],
        "SortName": "Vector [2]",
        "KValue": "28",
        "KValueNamespace": "bingbox",
        "AmgId": "P   362877",
        "ZuneId": "89C90600-0200-11DB-89CA-0019B92A3933",
        "SubGenres": [{
            "Name": "Contemporary Hip Hop"
        }],
        "AllTimePlayCount": 995.0,
        "SevenDaysPlayCount": 2.0,
        "ThirtyDaysPlayCount": 57.0,
        "LegacyAmgId": "7D890500-0600-11DB-89CA-0019B92A3933",
        "LegacyIds": [{
            "IdType": "AmgId",
            "Value": "P   362877"
        },
        {
            "IdType": "ZuneId",
            "Value": "89C90600-0200-11DB-89CA-0019B92A3933"
        },
        {
            "IdType": "LegacyAmgId",
            "Value": "7D890500-0600-11DB-89CA-0019B92A3933"
        },
        {
            "IdType": "ArtistId",
            "Value": "444809"
        }]
    }],
    "ContinuationToken": "1-----1",
    "ImpressionGuid": "9e41e6e4-1b2e-4710-abe4-b01ffbaa7605"
}
         
```

## 참고 항목

##### 상위 항목

[/media/{marketplaceId}/crossMediaGroupSearch](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-localecrossmediagroupsearch)

##### 추가 정보

[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)

[추가 참조](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)
