/media//details

返回一个或多个项的产品详细信息和元数据。这些 URI 的域为 eds.xboxlive.com。 details API 与 Related API 和 Browse API(传入 ID 时)不同,后两者返回的是与给定 ID 显式或隐式关联的其他项的信息,而 details API 返回的是有关同一项的其他信息。可以在一次调用中传入多个不同媒体项类型的 ID(只要它们的类型不是 ProviderContentID — 请参见下文),但它们必须属于同一个媒体组。但是,在某些客户端场景下,调用者并不知道媒体组。为此,该 API 允许在以下情况下将媒体组指定为特殊值 “Unknown”:

idType = XboxHexTitle,将产生 AppType 或 GameType 项
idType = ProviderContentId,将产生 MovieType 或 TVType 项

下表汇总了可为哪些媒体组提供哪些 ID 类型的完整映射关系:

ID Type	AppType	GameType	MovieType	MusicArtistType	MusicType	TVType	WebVideoType	Unknown
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
Offer	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

参数说明
URI 参数

参数说明

ProviderContentId

用于查找特定于提供程序的 ID。例如 Netflix Id 或 Hulu Id。当 idType 为 ProviderContentId 时,只接受单个值。这是因为 ProviderContentIds 是唯一可以包含 ’.’ 字符的 ID 类型。由于 ’.’ 字符也是我们用于在多个 ID 之间进行分隔的分隔符,因此对于哪些字符是 ID 之间的分隔符、哪些字符是 ID 本身的一部分,存在歧义。API 的其余部分对 ProviderContentIds 的处理方式相同,批量查找功能除外。

URI 参数

参数	类型	说明
marketplaceId	string	必需。从 Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId 获取的字符串值。

有效方法

GET (/media//details) 返回一个或多个项的产品详细信息和元数据。

另请参阅

父主题

Marketplace URIs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

/media/{marketplaceId}/details

/media//details

参数说明

ProviderContentId

URI 参数

有效方法

另请参阅

父主题

更多信息

​/media//details

​参数说明

​ProviderContentId

​URI 参数

​有效方法

​另请参阅

父主题

更多信息

/media//details

参数说明

ProviderContentId

URI 参数

有效方法

另请参阅