ページネーションの使用

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

limitパラメーターとoffsetパラメーターを使用して、クエリをページ分割できます。limitを使用して、応答に必要な結果の最大数を指定し、offsetを使用してスキップする結果の数を示します。

limitパラメーターとoffsetパラメーターのデータモデルについては、Searchと推奨事項APIリファレンスを参照してください。

複数のページの検索結果を取得する。

複数のページを含む検索結果を取得するには、limitパラメーターをページごとに表示する結果の数に設定し、offsetパラメーターを前のページで表示した結果の数に設定します。

たとえば、検索結果の2ページ目に、各ページに5つの項目があるとします。

次のコード サンプルは、要求を作成する方法を示しています。

{
    "widget": {
        "items": [
            {
                "rfk_id": "rfkid_7",
                "entity": "content",
                "search": {
                    "content": {},
                    "limit": 5,
                    "offset": 5
                },
                "sources": [
                    "407033",
                    "408162",
                    "406277",
                    "406278"
                ]
            }
        ]
    },
    "context": {
        "locale": {
            "country": "us",
            "language": "en"
        }
    }
}

無限スクロールで検索結果を取得する

無限スクロールの検索結果の場合、訪問者が検索結果ページにアクセスしたときに最初にリクエストを送信し、次に訪問者が特定の数の結果を超えてスクロールするたびに変更されたリクエストを送信します。

たとえば、無限スクロールの検索結果ページが必要であるとします。訪問者が50件の結果を渡した後、さらに10件の結果を表示します。ここからは、訪問者が10番目の結果ごとに渡した後、さらに10個の結果を表示します。

最初に行う呼び出しは次のとおりです。

{
    "widget": {
        "items": [
            {
                "rfk_id": "rfkid_7",
                "entity": "content",
                "search": {
                    "content": {},
                    "limit": 50,
                    "offset": 0
                },
                "sources": [
                    "407033",
                    "408162"
                ]
            }
        ]
    },
    "context": {
        "locale": {
            "country": "us",
            "language": "en"
        },
        "user": {
            "uuid": "159871551-io-0i-4e-1p-s6ill6vhenvysbu27bbk-1664389956369"
        }
    }
}

訪問者が50番目の結果を超えてスクロールしたら、searchオブジェクトを次のように変更します。

{
    "search": {
        "content": {},
        "limit": 10,
        "offset": 50
    }
}

訪問者がスクロールして、前のリクエストを送信した後に表示された10個の新しい結果を過ぎた後、searchオブジェクトを次のように変更します。

{
    "search": {
        "content": {},
        "limit": 10,
        "offset": 60
    }
}
この記事を改善するための提案がある場合は、 お知らせください!