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

# /media/{marketplaceId}/details

> /media/{marketplaceId}/details

傳回一或多個項目的優惠詳細資料和中繼資料。
這些 URI 的網域是 `eds.xboxlive.com`。

詳細資料 API 與相關 API 和瀏覽 API (傳入識別碼時) 不同，後兩者會傳回以明確或隱含方式與指定識別碼相關聯之其他項目的資訊，而詳細資料 API 則會傳回同一項目的其他資訊。

可以在單一呼叫中傳入不同媒體項目類型的多個識別碼 (只要它們不是 ProviderContentID 類型，請參閱下文)，但它們都必須屬於同一個媒體群組。不過，在某些用戶端案例中，呼叫者並不知道媒體群組。在下列情況下，API 允許媒體群組使用特殊值 "Unknown" 來支援此情形：

* idType = XboxHexTitle，這會產生 AppType 或 GameType 項目
* idType = ProviderContentId，這會產生 MovieType 或 TVType 項目

下表摘要說明哪些識別碼類型可以搭配哪些媒體群組提供的完整對應：

| ID 類型 | 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

這用於查閱提供者特定的識別碼，例如 Netflix 識別碼或 Hulu 識別碼。

當 idType 為 ProviderContentId 時，只接受單一值。這是因為 ProviderContentId 是唯一可以包含 '.' 字元的識別碼類型。由於 '.' 字元也是我們在識別碼之間使用的分隔符號，因此無法區分哪些是識別碼之間的分隔符號，哪些是識別碼本身的一部分。除了大量查閱功能之外，API 的其餘部分對 ProviderContentId 的運作方式都相同。

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| marketplaceId | string | 必要。從 **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId** 取得的字串值。 |

## 有效方法

[GET (/media/{marketplaceId}/details)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocaledetailsget.md)

  傳回一或多個項目的優惠詳細資料和中繼資料。

## 另請參閱

##### 上層

[Marketplace URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)

##### 進一步資訊

[EDS 通用標頭](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edscommonheaders.md)

[EDS 參數](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsparameters.md)

[EDS 查詢精簡器](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsqueryrefiners.md)

[其他參考](https://docs.xbox.com/zh-TW/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [GET (/media/{marketplaceId}/details)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocaledetailsget.md)
- [/media/{marketplaceId}/fields](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalefields.md)
- [/media/{marketplaceId}/browse](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalebrowse.md)
- [GET (/media/{marketplaceId}/fields)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalefieldsget.md)
- [GET (media/{marketplaceId}/browse)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalebrowseget.md)