Skip to main content

/media//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 タイプがどのメディア グループと組み合わせられるかの全体のマッピングをまとめたものです:

パラメーターに関する注意

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//details)   1 つ以上の項目に関するオファーの詳細とメタデータを返します。

関連項目

親
Marketplace URI
詳細情報
EDS 共通ヘッダー EDS パラメーター EDS クエリ絞り込み条件 追加リファレンス
Last modified on October 19, 2026