> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /media/{marketplaceId}/details

> /media/{marketplaceId}/details

# /media/{marketplaceId}/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 |

* [参数说明](#ID4EEH)
* [URI 参数](#ID4EUH)

## 参数说明

### 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/{marketplaceId}/details)](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocaledetailsget)

  返回一个或多个项的产品详细信息和元数据。

## 另请参阅

##### 父主题

[Marketplace URIs](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

##### 更多信息

[EDS 通用标头](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edscommonheaders)

[EDS 参数](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsparameters)

[EDS 查询精简器](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsqueryrefiners)

[其他参考](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Economy v2 Catalog Content Types, Tags, & Properties](https://devdocs.xbox.com/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](https://devdocs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](https://devdocs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](https://devdocs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)