本頁面說明如何依日期排序網頁搜尋查詢的結果。
- 如果資料儲存庫使用基本網站搜尋功能,您可以依據 Google 推斷的網頁日期排序。
- 如果資料儲存庫使用進階網站索引,您可以依照自訂資料屬性或 Google 推斷的網頁日期排序,這些屬性或日期會加入資料儲存庫結構定義。詳情請參閱「使用結構化資料進行進階網站索引」。
事前準備
請務必完成以下操作:
為基本網站搜尋功能排序搜尋結果
如要為使用基本網站搜尋功能的網站資料儲存庫排序搜尋結果,請按照下列步驟操作:
REST
以下範例說明如何透過基本網站搜尋功能,為應用程式中的網頁搜尋結果排序。這個範例使用 engines.servingConfigs.search
方法:
找出應用程式 ID。如果您已取得應用程式 ID,請直接跳到下一個步驟。
前往 Google Cloud 控制台的「AI Applications」頁面。
在「Apps」頁面中找出應用程式名稱,然後從「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 搜尋瞭解網頁的最佳日期」網誌文章。預設排序順序為遞減排序,系統會優先傳回最近日期的網頁。如要取得遞增排序順序,請將:a
附加至date
值date:a
。
進階網站索引建立功能的搜尋結果排序
如要為網站資料儲存庫 (含進階網站索引) 排序搜尋結果,請按照下列步驟操作:
REST
以下範例說明如何使用進階網站索引功能,為應用程式排序網頁搜尋結果。這個範例使用 engines.servingConfigs.search
方法:
找出應用程式 ID。如果您已取得應用程式 ID,請直接跳到下一個步驟。
前往 Google Cloud 控制台的「AI Applications」頁面。
在「Apps」頁面中找出應用程式名稱,然後從「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"
。預設排序順序是遞增,也就是先傳回較舊的網頁。如要以遞減順序取得結果,請在自訂屬性值 (例如"orderBy":"date_edited desc"
) 後方附加desc
。