返回有关一个或多个项目的优惠详细信息和元数据。
这些 URI 的域是 eds.xboxlive.com。
详细信息 API 不同于相关 API 和浏览 API（当传入 ID 时），这些 API 显式或隐式返回与给定 ID 关联的其他项目的信息，而详细信息 API 返回相同项目的其他信息。
可以将不同媒体项目类型的多个 ID 传递到单个调用（只要它们不是 ProviderContentID 类型，如下所示），但它们必须都属于同一个媒体组。 但是，在几个客户端方案中，调用方不知道媒体组。 该 API 通过在以下情况下允许媒体组使用特殊值“未知”来支持这一点：
- idType = XboxHexTitle，将生成 AppType 或 GameType 项目
- idType = ProviderContentId，将生成 MovieType 或 TVType 项目
以下图表总结了可为哪些 ID 类型提供哪些媒体组的整个映射：
| ID 类型 | AppType | GameType | MovieType | MusicArtistType | MusicType | TVType | WebVideoType | 未知 |
|---|---|---|---|---|---|---|---|---|
| Canonical | Y | Y | Y | Y | Y | Y | Y | N |
| ZuneCatalog | N | N | Y | Y | Y | Y | N | N |
| ZuneMediaInstance | N | N | Y | N | Y | Y | N | N |
| 优惠 | Y | Y | Y | N | Y | Y | N | N |
| AMG | N | N | N | N | Y | N | N | N |
| MediaNet | N | N | N | N | Y | N | N | N |
| XboxHexTitle | Y | Y | N | N | N | N | N | Y |
| ProviderContentId | N | N | Y | N | N | Y | N | Y |
参数说明
ProviderContentId
这用于查找提供商特定 ID，例如 Netflix ID 或 Hulu ID。
当 idType 为 ProviderContentId 时，只接受单个值。 这是因为 ProviderContentId 是可以包含‘.’字符的唯一 ID 类型。 由于‘.’字符也是我们在 ID 之间使用的分隔符，因此 ID 之间的分隔符和 ID 本身的各部分之间就会不明确。 除了批量查找功能外，该 API 的其余部分与 ProviderContentId 的工作方式相同。
URI 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| marketplaceId | 字符串 | 必需。 从 Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId 获取的字符串值。 |
有效方法
GET (/media/{marketplaceId}/details)
返回有关一个或多个项目的优惠详细信息和元数据。