EDS クエリ絞り込み
次のパラメーターは、Entertainment Discovery Services (EDS) のクエリをより対象を絞ったアイテム セットに絞り込むために使用できます。これらのパラメーターはどの API でも必須ではありませんが、クエリ絞り込みを受け付けるすべての API で受け付けられます。 パラメーター名は、任意の “queryRefiners” パラメーターに値として渡すことができます。これにより、クエリ絞り込みを適用してリクエストを繰り返した場合に返されるアイテムの数が、クエリ絞り込みの各値ごとに分けて返されます。 実際にこれがどのように機能するかの例を以下に示します。- browse API への呼び出しが、パラメーター “queryRefiners=genre” を含めて行われます。
- API は 8 個のゲームを返します。アイテムに加えて、アイテムを含む各ジャンルの一覧と、そのジャンルに属するアイテム数が返されます。ゲームの場合、これは “Shooter: 3, Puzzle: 5” のようになります。
- 2 回目のクエリが行われます。これは 1 回目と同じですが、“genre=Shooter” が追加されている点が異なります。
- レスポンスには “Shooter” カテゴリに属する 3 個のゲームのみが含まれるようになります。