---
title: "ファセット探索の利用"
slug: "using-faceted-search"
abstract: "facetsで検索結果を得るために、Sitecore SearchのSearchと推奨APIの使い方を学びましょう。"
---
# ファセット探索の利用

ファセットをリクエストするには、リクエストにwidget.items.search.facetオブジェクトを追加してください。

> !注facetsを取得する前に、管理者が[Searchでfacets](https://doc.sitecore.com/search/en/users/search-user-guide/refine-search-results.html)の属性を設定していることを確認してください。

このオブジェクトのデータモデルについては、[Search and Recommendation APIリファレン](https://doc.sitecore.com/search/en/developers/search-and-recommentation-api/index.html)スを参照してください。

以下のセクションでは、facetsを取得するためのサンプル要求を示します。

## 利用可能なすべてのfacetsを入手

利用可能なすべてのfacetsを得るには、allキーをtrueに設定してください。

以下はサンプルリクエストです:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "content",
 "search": {
 "facet": {
 "all": true
 }
 }
 }
 
 },
 "context": {
 "locale": {
 "country": "us",
 "language": "en"
 },
 "user": {
 "uuid": "159871551-io-0i-4e-1p-s6ill6vhenvysbu27bbk-1664389956369"
 }
 }
}

以下はこの要請への回答です。

{
 "widgets": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "content",
 "facet": 
 {
 "name": "product",
 "label": "Product",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiRXhwZXJpZW5jZSBQbGF0Zm9ybSAoWFApIn0=",
 "text": "Experience Platform (XP)",
 "count": 130
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiRXhwZXJpZW5jZSBNYW5hZ2VyIChYTSkifQ==",
 "text": "Experience Manager (XM)",
 "count": 80
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiQ29udGVudCBIdWIifQ==",
 "text": "Content Hub",
 "count": 73
 }
 ...
 
 },
 {
 "name": "type",
 "label": "Type",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoidHlwZSIsInZhbHVlIjoib3RoZXIifQ==",
 "text": "other",
 "count": 990
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoidHlwZSIsInZhbHVlIjoibmV3cyJ9",
 "text": "news",
 "count": 623
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoidHlwZSIsInZhbHVlIjoiQmxvZ3MifQ==",
 "text": "Blogs",
 "count": 519
 }
 ...
 
 }
 
 }
 ,
 "dt": 62,
 "ts": 1669437158552
}

オブジェクトfacet応答では、利用可能なfacets productとtypeが現れています。各ファセット配列には、そのファセットタイプのファセット値に対応するオブジェクトがあります。

## 一方の面の値を取得

ファセットの値を得るには、そのファセットのnameを渡し、max数の値を渡します。

例えば、プロダクトの側面に対して5つの値を表示したい場合です。以下はサンプルリクエストです:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "content",
 "search": {
 "facet": {
 "types": 
 {
 "name": "product",
 "max": 5
 }
 
 }
 }
 }
 
 },
 "context": {
 "locale": {
 "country": "us",
 "language": "en"
 },
 "user": {
 "uuid": "159871551-io-0i-4e-1p-s6ill6vhenvysbu27bbk-1664389956369"
 }
 }
}

以下はこの要請への回答です。

{
 "widgets": {
 "rfkid\_7": {
 "facet": {
 "product": {
 "label": "Product",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiRXhwZXJpZW5jZSBQbGF0Zm9ybSAoWFApIn0=",
 "text": "Experience Platform (XP)",
 "count": 137
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiRXhwZXJpZW5jZSBNYW5hZ2VyIChYTSkifQ==",
 "text": "Experience Manager (XM)",
 "count": 83
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiQ29udGVudCBIdWIifQ==",
 "text": "Content Hub",
 "count": 73
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiQ3VzdG9tZXIgRGF0YSBQbGF0Zm9ybSJ9",
 "text": "Customer Data Platform",
 "count": 68
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoicHJvZHVjdCIsInZhbHVlIjoiT3JkZXJDbG91ZCJ9",
 "text": "OrderCloud",
 "count": 35
 }
 
 }
 }
 }
 },
 "dt": 38,
 "ts": 1666323029989
}

オブジェクトfacet応答には、5つの値を持つProduct面が見えます。

## 動的属性コレクションからトップのfacetsを取得しましょう

動的属性コレクションからトップ値を取得するには、動的属性コレクション名をnameとして渡します。また、見たい数を指定するためにmax値を渡すこともできます。

例えば、attribute\_tags動的属性コレクションの上位5つの値を見たい場合です。以下はサンプルリクエストです:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "product",
 "search": {
 "facet": {
 "types": 
 {
 "name": "attribute\_tags",
 "max": 5
 }
 
 }
 }
 }
 
 },
 "context": {
 "locale": {
 "country": "us",
 "language": "en"
 }
 }
}

以下はこの要請への回答です。

{
 "widgets": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "product",
 "facet": 
 {
 "name": "attribute\_tags.ID13",
 "label": "Material",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNyIsInZhbHVlIjoiVGV4dGlsZSJ9",
 "text": "Textile",
 "count": 3135
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNyIsInZhbHVlIjoiUGxhc3RpYyJ9",
 "text": "Plastic",
 "count": 2852
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNyIsInZhbHVlIjoiQWx1bWludW0ifQ==",
 "text": "Aluminum",
 "count": 2691
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNyIsInZhbHVlIjoiUG9seWVzdGVyIn0=",
 "text": "Polyester",
 "count": 2220
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNyIsInZhbHVlIjoiTGVhdGhlciJ9",
 "text": "Leather",
 "count": 2109
 }
 
 },
 {
 "name": "attribute\_tags.ID354",
 "label": "Type - Engine",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzNTYiLCJ2YWx1ZSI6IlR3aW4gQ2FtIFN0eWxlIn0=",
 "text": "Twin Cam Style",
 "count": 23137
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzNTYiLCJ2YWx1ZSI6IkV2b2x1dGlvbiBTdHlsZSJ9",
 "text": "Evolution Style",
 "count": 14384
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzNTYiLCJ2YWx1ZSI6Ik1pbHdhdWtlZS1FaWdodCAxMDcifQ==",
 "text": "Milwaukee-Eight 107",
 "count": 13086
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzNTYiLCJ2YWx1ZSI6Ik1pbHdhdWtlZS1FaWdodCAxMTQifQ==",
 "text": "Milwaukee-Eight 114",
 "count": 12629
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzNTYiLCJ2YWx1ZSI6Ik1pbHdhdWtlZS1FaWdodCAxMTcgICJ9",
 "text": "Milwaukee-Eight 117 ",
 "count": 10246
 }
 
 },
 {
 "name": "attribute\_tags.ID2",
 "label": "Color",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzIiwidmFsdWUiOiJCbGFjayJ9",
 "text": "Black",
 "count": 45536
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzIiwidmFsdWUiOiJHcmF5In0=",
 "text": "Gray",
 "count": 7904
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzIiwidmFsdWUiOiJCbHVlIn0=",
 "text": "Blue",
 "count": 6628
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzIiwidmFsdWUiOiJDaHJvbWUifQ==",
 "text": "Chrome",
 "count": 5021
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQzIiwidmFsdWUiOiJXaGl0ZSJ9",
 "text": "White",
 "count": 4843
 }
 
 }
 ...
 
 }
 ,
 "dt": 31,
 "ts": 1669044364271
}

オブジェクトfacet応答には、attribute\_tags.ID136 (米国サイズ)とattribute\_tags.ID138 (性別)という2つのファセットタイプが見られ、それぞれに多くの価値があります。

## 動的属性コレクションの特定の属性から値を取得する

動的属性コレクションから特定の属性を取得するには、欲しい特定の属性の名前を渡してください。

例えば、attribute\_tags動的属性コレクションからattribute\_tags.ID18とattribute\_tags.ID12属性を取得したい場合です。以下はサンプルリクエストです:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "product",
 "search": {
 "facet": {
 "types": 
 {
 "name": "attribute\_tags.ID18"
 },
 {
 "name": "attribute\_tags.ID12"
 }
 
 }
 }
 }
 
 },
 "context": {
 "locale": {
 "country": "us",
 "language": "en"
 }
 }
}

以下はこの要請への回答です。

{
 "widgets": 
 {
 "rfk\_id": "rfkid\_7",
 "entity": "product",
 "facet": 
 {
 "name": "attribute\_tags.ID18",
 "label": "U.S. Size",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxMyIsInZhbHVlIjoiTWVkaXVtIn0=",
 "text": "Medium",
 "count": 5166
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxMyIsInZhbHVlIjoiTGFyZ2UifQ==",
 "text": "Large",
 "count": 5003
 },

 ...
 
 },
 {
 "name": "attribute\_tags.ID12",
 "label": "Size",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNSIsInZhbHVlIjoiTGFyZ2UifQ==",
 "text": "Large",
 "count": 2513
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiYXR0cmlidXRlX3RhZ3MuSUQxNSIsInZhbHVlIjoiTWVkaXVtIn0=",
 "text": "Medium",
 "count": 2476
 },

 ...
 
 }
 
 }
 ,
 "dt": 531,
 "ts": 1669044284670
}