Skip to main content

GET (/media//details)

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

注釈

SandboxId は現在、XToken 内の要求 (claim) から取得され、強制されます。SandboxId が存在しない場合、Entertainment Discovery Services (EDS) は 400 Bad request エラーをスローします。

URI パラメーター

クエリ文字列パラメーター

| パラメーター| 種類| 説明| | --- | --- | --- | --- | --- | --- | | ids| string[]| 必須。詳細を返すすべての ID (最大 10 個)。URL に含めることができない文字を含む ID (ProviderContentId タイプの ID は通常フル URL であるため不正な文字を含みます) は、Entertainment Discovery Services (EDS) に正しく送信するために 必ず URL エンコードする必要があります。また、ID タイプが ProviderContentId の場合、これは単一の値のみになる点にも注意してください。複数の ProviderContentId が必要な場合は、EDS に対して複数回呼び出す必要があります。| | IdType| string| 省略可能。‘ids’ パラメーターに渡す ID のタイプ。有効な値は次のとおりです:
  • Canonical (Bing/Marketplace)
  • ZuneCatalog
  • ZuneMediaInstance (例: 132 kb WMA 音楽ファイル)
  • AMG
  • MediaNet (MusiWave 以前)
  • XboxHexTitle (コンソール上で実行されているアプリ)
| | DesiredMediaItemTypes| string| MediaGroup を渡さない場合は必須。両方を渡すべきではありません。 ID のメディア アイテム タイプ。提供されるすべての ID は同じタイプを共有する必要があります。複数のタイプが必要な場合は、上記の IdType に記載されているすべての可能なタイプを渡してください。この値は存在しない場合、既定で “Unknown” になりますが、すべての ID タイプに対して有効であるとは限りません。 | | MediaGroup| string| DesiredMediaItemTypes を渡さない場合は必須。両方を渡すべきではありません。| | ConditionSets| string| 省略可能。クライアントは、条件セット (このクエリ文字列で指定されたキーと値のペア) に基づく Availability のプルーニングを要求できます。これは、availability の条件セットとのマッチングに使用されます。条件セットのマッチングに使用できるキーの一覧は次のとおりです。
  • Platforms: 製品が構築され、プレイできる場所。
  • Subscriptions: この availability でサポートされるサブスクリプションのリスト (Gold または Silver)。
  • EntitlementIds: ユーザーがゲームを購入した後に追跡されます。
|

応答本文

サンプル応答

以下の JSON コードは、呼び出し /media/en-us/details?ids=6c5402e4-3cd5-4b29-a9c4-bec7d2c7514a&mediaGroup=GameType に対する応答です。

関連項目

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