EDS クエリの絞り込み条件
以下のパラメーターは、Entertainment Discovery Services (EDS) クエリを絞り込んでターゲットに近い項目セットを得るために使用できます。 以下のパラメーターはどの API でも必須ではありませんが、クエリ絞り込み条件を指定できる任意の API で使用できます。
パラメーター名は、任意の "queryRefiners" パラメーターに値として渡すことができます。 これにより、クエリ絞り込み条件を適用して要求を繰り返した場合に返される見込みの項目数が、クエリ絞り込み条件の値ごとに分けて返されます。
実際には以下のように機能します。
- パラメーター "queryRefiners=genre" を指定して参照 API が呼び出されます。
- API は 8 つのゲームを返します。 項目に加えて、項目が存在する各ジャンルのリストが、そのジャンルに属する項目の個数と共に返されます。 ゲームの場合、"Shooter: 3, Puzzle: 5" のようになります。
- 2 回目のクエリが行われます。 これは、"genre=Shooter" が追加されることを除いて、最初のクエリと同じです。
- 応答に含まれるゲームは 3 つだけになり、これらはすべて "Shooter" カテゴリーに属します。
| パラメーター | Data Type | 説明 |
|---|---|---|
| decade | 文字列 | すべての項目がリリースされた年代 (10 年単位)。 |
| genre | 文字列の配列 | すべての項目が持っているジャンルのリスト。 |
| labelOwner | 文字列 | アーティスト、アルバム、またはトラックに関連付けられている音楽ラベル。 |
| network | 文字列の配列 | 項目を作成したネットワーク。 |
| studio | 文字列の配列 | 項目を作成したスタジオ。 |
| xboxAppCategories | 文字列の配列 | すべての Xbox アプリが持っているカテゴリーのリスト。 |
| xboxAvatarClothes | 文字列の配列 | すべての Xbox アバター項目が持っている服装タイプのリスト。 |
| xboxAvatarStores | 文字列の配列 | すべての Xbox アバター項目が属するストアのリスト。 |
| xboxGamePublisherBits | 文字列の配列 | すべての GameType 項目または AppType 項目に設定する必要があるゲーム パブリッシャー ビットのリスト。 |
| xboxIsBrowsable | ブール値 | true の場合、実行可能なコンテンツに加えて、直接実行できない完全版ゲームを返します。 既定は false です。 |
| xboxHasChildMediaItemTypes | 文字列の配列 | Game のメディア グループによって返されるすべての項目には、そのメディア項目タイプが指定された値のいずれかである子の項目が必要です。 |