GET (media//browse)
允许浏览单个媒体组中的项。 这些 URI 的域为eds.xboxlive.com。
备注
可以使用 skipItems 参数而不是延续令牌来非顺序地访问从此搜索返回的数据页。此 API 接受查询精简器。 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 参数。响应正文
响应示例
以下 JSON 代码是对调用/media/en-us/browse?orderBy=releaseDate&desiredMediaItemTypes=DGame&fields=all 的响应。
{
"Items": [{
"MediaGroup": "GameType",
"MediaItemType": "DGame",
"ID": "6c5402e4-3cd5-4b29-a9c4-bec7d2c7514a",
"Name": "Tanks-A",
"ReducedName": "Tanks-A short title",
"ReleaseDate": "2013-05-14T00: 00: 00Z",
"TitleId": "1676B413",
"VuiDisplayName": "Tanks-A vui",
"DeveloperName": "Microsoft Studios",
"PublisherName": "Microsoft Studios",
"SortName": "Tanks-A sort title. ",
"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": "1676B413"
}],
"Availabilities": [{
"AvailabilityID": "",
"ContentId": "c9fcb807-626d-5347-b918-65496f084219",
"Devices": [{
"Name": "Durango"
}]
}],
"Packages": [{
"CdnFileLocation": [{
"SortOrder": null,
"Uri": "www.microsoft.com"
}],
"ContentId": "c9fcb807-626d-5347-b918-65496f084219",
"GameRegionMask": 1,
"PackageType": "CAB",
"LicenseBit": 1,
"LicenseType": "SyncCast DTO"
}],
"SandboxId": "PART.Dev1"
},
{
"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": "5",
"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": "5d3085cf-7d17-43b4-a9c1-a1ccfe764eb1"
}