> ## 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

1 つ以上の項目に関するオファーの詳細とメタデータを返します。
これらの URI のドメインは `eds.xboxlive.com` です。

details API は、Related API や Browse API (ID を渡す場合) とは異なります。これらの API は、指定された ID に関連付けられている他の項目 (明示的または暗黙的) に関する情報を返しますが、details API は同じ項目に関する追加情報を返します。

1 回の呼び出しで、異なるメディア アイテム タイプの複数の 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 の場合、単一の値のみが受け入れられます。これは、ProviderContentId は '.' 文字を含めることができる唯一の ID タイプであるためです。'.' 文字は ID 間の区切り文字としても使用しているため、ID 間の区切り文字と ID 自体の一部との間にあいまいさが生じます。API の残りは ProviderContentId に対しても同じように動作しますが、一括検索機能を除きます。

## URI パラメーター

| パラメーター | 種類 | 説明 |
| - | - | - |
| marketplaceId | string | 必須。**Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId** から取得される文字列値。 |

## 有効なメソッド

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

  1 つ以上の項目に関するオファーの詳細とメタデータを返します。

## 関連項目

##### 親

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

##### 詳細情報

[EDS 共通ヘッダー](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edscommonheaders.md)

[EDS パラメーター](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edsparameters.md)

[EDS クエリ絞り込み条件](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edsqueryrefiners.md)

[追加リファレンス](https://docs.xbox.com/ja-jp/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

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