---
title: "最大限界を超える面の値を返す"
slug: "return-facet-values-beyond-the-maximum-limit"
abstract: "Searchと推奨APIの使い方を学び、最大限度を超えて返facets Sitecore Search。"
---
# 最大限界を超える面の値を返す

Sitecore Searchでは、返されるfacetsのデフォルト数は10です。APIリクエストのmaxパラメータを使って返されるファセット値の数を設定できます。ただし、リクエストあたりの絶対最大100個までです。パフォーマンスと安定性を確保しつつ、100以上のファセット値を返す必要がある場合もあります。

最初の100以降の結果は、以下のいずれかのオプションで返すことができます:

-   afterパラメータ - ページ化
-   keyphraseパラメータ

> !警告ページ分けとkeyphraseフィルタリングを同時に使うことはできません。

## ページ付けの使用

ファセット値内にページを割り当てることで、すべての結果を返すことができます。 afterパラメータはファセットIDで定義されたものの後に続くすべての結果を返します。

> !注これは、あなたのファセットが [用語ファセット](https://doc.sitecore.com/search/en/users/search-user-guide/en/use-an-attribute-as-a-facet.html#UUID-0762b28a-cd14-4b25-5429-b398e04fc3e2_section-idm4604419901508833710985874428)であり、テキストごとにソートされ、並べascまたはdescソートが適用される必要があります。

例えば、最初のリクエストで100件の結果が返された場合、最後に受け取った項目をafterの値を設定して別のリクエストを実行することができます。これにより、101以降の結果が返されます。以下の2つのサンプルリクエストとレスポンスは、その方法を示しています。

このサンプルリクエストは、以下のサンプルリクエストを用いて、すべてのcategory\_breadcrumbs facetsをアルファベット順(テキスト、昇順)で最大100まで要求する方法を示しています:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "product\_services",
 "search": {
 "content": {},
 "facet": {
 "all": false,
 "types": 
 {
 "name": "category\_breadcrumbs",
 "sort": {
 "name": "text",
 "order": "asc"
 }
 }
 ,
 "max": 100
 },
 "offset": 0,
 "limit": 15
 },
 "entity": "content"
 }
 
 }
}

応答は最初の100個の面の価値をアルファベット順に表示します。スペースを保つため、このサンプル応答は最初の値のみを表示します。

{
 "widgets": 
 {
 "rfk\_id": "product\_services",
 "type": "preview\_search",
 "used\_in": "common\_across\_pages",
 "entity": "content",
 "facet": 
 {
 "name": "category\_breadcrumbs",
 "label": "Category Breadcrumbs",
 "value": 
 …
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL09wdGltaXphdGlvbiJ9",
 "text": “Digital Solutions/Optimization",
 "count": 13
 }
 
 }
 ,
 "content": 
 …
 ,
 "total\_item": 2113,
 "limit": 15,
 "offset": 0
 }
 ,
 "dt": 12,
 "ts": 1734517554835
}

このサンプルリクエストは、上記の結果から最後のfacetidを加え、afterパラメータに置く方法を示しています。

{
 "widget": {
 "items": 
 {
 "rfk\_id": "product\_services",
 "search": {
 "content": {},
 "facet": {
 "all": false,
 "types": 
 {
 "name": "category\_breadcrumbs",
 "after": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL09wdGltaXphdGlvbiJ9",
 "sort": {
 "name": "text",
 "order": "asc"
 }
 }
 ,
 "max": 100
 },
 "offset": 0,
 "limit": 15
 },
 "entity": "content"
 }
 
 }
}

このサンプル回答は、Sitecore Searchがアルファベット順に最大100個の面値を返す方法を示しています。 Digital Solutions/Optimizationの後の結果から始まります(この例では2つのみ含めています):

{
 "widgets": 
 {
 "rfk\_id": "product\_services",
 "type": "preview\_search",
 "used\_in": "common\_across\_pages",
 "entity": "content",
 "facet": 
 {
 "name": "category\_breadcrumbs",
 "label": "Category Breadcrumbs",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL090aGVyIEluZHVzdHJpZXMifQ==",
 "text": “Digital Solutions/Other Industries",
 "count": 2
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL1Byb2R1Y3Rpb24ifQ==",
 "text": “Digital Solutions/Production",
 "count": 17
 },
 …
 
 }
 ,
 "content": 
 …
 ,
 "total\_item": 2113,
 "limit": 15,
 "offset": 0
 }
 ,
 "dt": 21,
 "ts": 1734518180187
}

## keyphraseパラメータを使いましょう

widget.items.search.facet.types.keyphraseのkeyphraseパラメータを使ってファセット値を検索できます。次の例では、Drilling。

これがサンプルリクエストです:

{
 "widget": {
 "items": 
 {
 "rfk\_id": "product\_services",
 "search": {
 "content": {},
 "facet": {
 "all": false,
 "types": 
 {
 "name": "category\_breadcrumbs",
 "keyphrase": "Drilling"
 }
 
 },
 "offset": 0,
 "limit": 15
 },
 "entity": "content"
 }
 
 }
}

これがサンプル応答です:

{
 "widgets": 
 {
 "rfk\_id": "product\_services",
 "type": "preview\_search",
 "used\_in": "common\_across\_pages",
 "entity": "content",
 "facet": 
 {
 "name": "category\_breadcrumbs",
 "label": "Category Breadcrumbs",
 "value": 
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nIn0=",
 "text": "Drilling",
 "count": 309
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Rvd25ob2xlIERyaWxsaW5nIFRlY2hub2xvZ2llcyJ9",
 "text": "Drilling/Downhole Drilling Technologies",
 "count": 74
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Zpc2hpbmcgVG9vbHMifQ==",
 "text": "Drilling/Fishing Tools",
 "count": 26
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0N1dHRpbmdzIGFuZCBXYXN0ZSBNYW5hZ2VtZW50In0=",
 "text": "Drilling/Cuttings and Waste Management",
 "count": 23
 },
 {
 "id": "facetid\_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Rvd25ob2xlIERyaWxsaW5nIFRlY2hub2xvZ2llcy9EaXJlY3Rpb25hbCBTeXN0ZW1zIn0=",
 "text": "Drilling/Downhole Drilling Technologies/Directional Systems",
 "count": 23
 }
 
 }
 ,
 "content": 
 …
 ,
 "total\_item": 2113,
 "limit": 15,
 "offset": 0
 }
 ,
 "dt": 15,
 "ts": 1734519150250
}

詳細については、[Search and Recommendation API参照](https://doc.sitecore.com/search/en/developers/search-and-recommentation-api/index.html) ドキュメントをご覧ください。