/media/{marketplaceId}/details

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

  返回有关一个或多个项目的优惠详细信息和元数据。

另请参阅

父级

市场 URI

补充信息

EDS 通用标头

EDS 参数

EDS 查询优化器

其他参考