GET (/media/{marketplaceId}/crossMediaGroupSearch)
いくつかの異なるメディア グループから項目を取得します。
これらの URI のドメインは eds.xboxlive.com
です。
解説
グループ間 API を使用すると、クライアントは複数の異なるメディア グループから項目を検索することができます。 この API では、結果間でのページ移動の際に順方向専用の継続トークンを使用する必要があります。 この API はクエリ絞り込み条件を受け入れます。
SandboxId は XToken のクレームから取得されて適用されます。 SandboxId が存在しない場合は、Entertainment Discovery Services (EDS) が 400 Bad Request エラーをスローします。
URI パラメーター
パラメーター | 型 | 説明 |
---|---|---|
marketplaceId | 文字列 | 必須。 Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId から取得される文字列値。 |
クエリ文字列パラメーター
パラメーター | 型 | 説明 |
---|---|---|
continuationToken | 文字列 | オプション。 ContinuationToken パラメーターを参照してください。 |
q | 文字列 | 必須。 検索で使用するクエリ用語。 |
応答の本文
サンプル応答
下の JSON コードは、/media/en-us/crossMediaGroupSearch?q=vector&maxItems=25&fields=all
呼び出しへの応答です。
{
"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