このページでは、ウェブ検索クエリの結果を日付順に並べ替える方法について説明します。
- 基本的なウェブサイト検索を使用するデータストアでは、Google が推定したページの日付で並べ替えることができます。
- 高度なウェブサイト インデックスを使用するデータストアでは、カスタムデータ属性またはデータストア スキーマに追加された Google 推定ページ日付で並べ替えることができます。詳しくは、ウェブサイトの高度なインデックス登録に構造化データを使用するをご覧ください。
始める前に
次の処理を行っていることを確認してください。
ウェブサイトのデータを含むデータストアを作成します。詳細については、ウェブサイトの URL をご覧ください。
検索アプリを作成し、データストアに接続します。詳細については、検索アプリを作成するをご覧ください。
基本的なウェブサイト検索の検索結果を並べ替える
基本的なウェブサイト検索でウェブサイト データストアの検索結果を並べ替える手順は次のとおりです。
REST
次のサンプルは、基本的なウェブサイト検索を使用して、アプリのウェブ検索結果を並べ替える方法を示しています。このサンプルでは、engines.servingConfigs.search
メソッドを使用します。
アプリ ID を確認します。アプリ ID がすでにある場合は、次のステップに進みます。
Google Cloud コンソールで、[Agent Builder] ページに移動します。
[アプリ] ページでアプリの名前を見つけ、[ID] 列からアプリの ID を取得します。
検索クエリを作成し、
orderBy
フィールドを含めます。curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \ -d '{ "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search", "query": "QUERY", "orderBy": "ORDER_BY" }'
以下を置き換えます。
- PROJECT_ID: Google Cloud プロジェクトの ID。
- APP_ID: Vertex AI Search アプリの ID。
- QUERY: 検索するクエリテキスト。
- ORDER_BY: 結果の並べ替え順序。たとえば、時系列で並べ替えるには、
date
を指定して、Google が推定したページの日付で並べ替えられたウェブページを返します。Google が推定したページの日付について詳しくは、ウェブページの最適な日付を Google 検索に知らせるブログ投稿をご覧ください。デフォルトの並べ替え順序は降順で、日付が最も新しいページが最初に返されます。昇順で並べ替えるには、date
値(date:a
)に:a
を追加します。
ウェブサイトの高度なインデックス登録の検索結果を並べ替える
高度なウェブサイト インデックス登録を使用してウェブサイト データストアの検索結果を並べ替える手順は次のとおりです。
REST
次のサンプルは、ウェブサイトの高度なインデックス登録を使用してアプリのウェブ検索結果を並べ替える方法を示しています。このサンプルでは、engines.servingConfigs.search
メソッドを使用します。
アプリ ID を確認します。アプリ ID がすでにある場合は、次のステップに進みます。
Google Cloud コンソールで、[Agent Builder] ページに移動します。
[アプリ] ページでアプリの名前を見つけ、[ID] 列からアプリの ID を取得します。
検索クエリを作成し、
orderBy
フィールドを含めます。curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \ -d '{ "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search", "query": "QUERY", "orderBy": "ORDER_BY" }'
以下を置き換えます。
- PROJECT_ID: Google Cloud プロジェクトの ID。
- APP_ID: Vertex AI Search アプリの ID。
- QUERY: 検索するクエリテキスト。
- ORDER_BY: 結果の並べ替え順序。このフィールドには、日時、整数、数値のいずれかのデータ型の値を指定できます。時系列で並べ替えるには、スキーマで指定されたカスタム日付属性または Google が推定したページの日付を指定して、日付順に並べ替えられたウェブページを返します。たとえば、
date_edited
PageMap 属性で並べ替えるには、orderBy
フィールドを"orderBy": "date_edited"
として指定します。デフォルトの並べ替え順序は昇順で、古いページが先頭に返されます。結果を降順で取得するには、カスタム属性の値にdesc
を追加します(例:"orderBy":"date_edited desc"
)。