返回有关一个或多个项目的优惠详细信息和元数据。
这些 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)
返回有关一个或多个项目的优惠详细信息和元数据。