Cloud Talent Solution 可讓使用者搜尋您儲存於職缺搜尋索引中的職缺。Job Search 可供自訂，您可依據自身的業務需求來修改。本頁面為 CTS 職缺搜尋中可用的搜尋功能總覽。
發出搜尋要求
如要提出職缺搜尋要求，請將 POST 要求傳送至 jobs:search 端點，在要求主體中傳送搜尋資料。
常用欄位 (選用)
JobQuery：JobQuery物件由兩個元件所組成，一個query字串和套用於該字串的篩選器。這項功能能讓使用者用一個或多個篩選器 (位置、通勤時間、薪酬等) 搜尋查詢字串 (例如「通勤助理」)。請參閱搜尋篩選器取得進一步資訊及可用篩選器清單。searchMode：指定要套用的搜尋類型。以下是可用選項：JOB_SEARCH(建議選項)：此為預設搜尋模式，可搜尋所有職缺物件。然後根據與搜尋查詢相關的程度，為使用者按順序傳回最相關的職缺。FEATURED_JOB_SEARCH：僅搜尋promotionValue大於 0 的職缺物件。結果會依promotionValue值排序，如果有相同的值，則會使用關聯性來決定位置。詳情請參閱精選職缺。
jobView：定義每個相符的職缺物件所傳回的欄位數量。可以是JOB_VIEW_SMALL(預設)、JOB_VIEW_MINIMAL或JOB_VIEW_FULL。如要瞭解每個選項的說明，請參閱JobView參考說明文件。orderBy：傳回職缺的排序順序。如要瞭解允許的值，請參閱參考資料文件。預設會按關聯性遞減排序 (RELEVANCE_DESC)。
必填欄位
以下是必填欄位：
requestMetadata：包含此搜尋要求的使用者和工作階段資訊。
RequestMetadata
每個搜尋和直方圖要求都必須包含一個 RequestMetadata 物件。此物件包含啟動搜尋的使用者相關資訊。這有兩個主要原因：
使用者一致性：Cloud Talent Solution 同時執行幾個版本的基礎模型，以改善搜尋關聯性。CTS 確保求職者 (識別依據為 userId、sessionId 和 domain) 可有一致的使用體驗。這些欄位應為模糊處理。
搜尋改善：微調演算法是根據
RequestMetadata欄位所提供的資訊，以及您提供的求職者資料。這會改善搜尋結果關聯性。
使用搜尋運算子
下表中的搜尋運算子可以單獨使用或合併使用。
| 運算子 | 說明 |
|---|---|
| ( ) | 將一或多個關鍵字組合在一起。 |
| OR | 搜尋與運算子任一側的關鍵字或關鍵字群組相關的結果。範例："software OR java" 會傳回中繼資料含有「software」或「java」的職缺。 |
| 且 | 搜尋與運算子兩側的關鍵字或關鍵字群組相關的結果。範例："(software OR java) AND (marketing)" 會傳回與「software」和「marketing」和相關聯的職缺，或與「java」和「marketing」相關聯的職缺。 |
| NOT | 排除運算子後方的關鍵字或關鍵字群組的相關結果。關鍵字或關鍵字群組必須位於括弧內。 |
| - | 排除運算子之後的關鍵字或關鍵字群組的相關結果。範例："software -java" 會傳回與「software」相關的職缺，但「排除」與「java」相關的職缺。 |
| req 或 requisition： | 傳回具有指定申請 ID 的職缺。範例：req:1234 傳回具有申請 ID 1234 的職缺。 |
求職者查詢
系統也可以將搜尋字詞做為實際的職缺相關實體進行偵測。舉例來說，如果使用者查詢「intern」，Cloud Talent Solution 會將其視為就業類型 INTERN，並篩選出標示為 EMPLOYMENT_TYPE - INTERN 的職缺。因此，如果該職缺的 EMPLOYMENT_TYPE 欄位設為其他值，即使職缺物件說明中含有「intern」，也不會傳回。
疑難排解
每個搜尋要求都會在職缺搜尋系統中產生不重複的搜尋 requestID。此值可用來追蹤搜尋的參數及回覆。這對於解決與特定搜尋、CRUD 要求相關的問題相當重要，請妥善記錄。在搜尋回應主體或相關的 CRUD 呼叫回應中，requestID 會傳回至 ResponseMetadata 欄位。
如有關聯性、搜尋查詢、索引查詢等相關支援問題需要協助，請向我們的支援團隊提交支援要求，並提供或要求提供相關 requestID 或要求內容。
使用控制台診斷資料問題
請使用 CTS 控制台中的「工作和公司」頁面，診斷工作資料相關問題。如果需要排解資料問題，您可以查看工作統計資料、搜尋特定工作中繼資料，以及依工作、公司或租用戶匯出資料。如要進一步瞭解如何使用這些工具，請參閱「職缺和公司資料」說明文件。
結果計數
顯示結果計數的目的是讓求職者看到系統傳回多少筆搜尋結果。這個數字不一定能夠對應直方圖結果或實際傳回的職缺數量。Job Search 最多會傳回 5000 個職缺。
分頁 (選用)
根據預設，工作搜尋服務會在單一呼叫中傳回 100 個結果 (如果結果總數少於 100 個，則會傳回更少的結果)。如要查看超過 100 個結果，您可以實作分頁功能。如果結果總數超過 5000 個，則包含第 5000 個結果的頁面之後的所有頁面都會空白。下方欄位可控制分頁：
pageSize：傳回的結果數量。nextPageToken：所傳回的搜尋結果每頁都會有不重複的符記，這個符記可指定結果下一頁的起始位置。如果沒有其他結果，則這個欄位會留空。offset：指定在頁面頂端傳回的職缺關聯性排名與 1 (傳回職缺中關聯性最高的職缺) 之間的位移。例如，使用者執行搜尋，將pageSize設為 10。第一頁的頁面頂端傳回 #1 的職缺，因此此頁的offset值為 0。下一頁的頁面頂端傳回 #11 的職缺，因此此頁的offset值為 10。
實作分頁的做法主要有兩種。您可以使用 pageSize 和 nextPageToken 直接指向下一頁的結果 (每個頁面都有一個新的 nextPageToken 值，指向後續頁面)。使用這個方法時，您一律會從結果頂端開始，並依序瀏覽頁面。或者，您也可以使用 pageSize 搭配 offset，直接指定哪個編號結果會顯示在每個頁面的頂端。使用 offset 而非 nextPageToken，可讓您跳至結果集的任何位置。
建議您將頁面大小設為 20 項結果或更少，以避免發生延遲問題。最佳做法為，在每個頁面發出分別的搜尋呼叫，再顯示給求職者。而不是使用單一搜尋呼叫傳回大量職缺，再在用戶端分頁，因為這會影響機器學習模型透過 Jobs Analytics Framework 準確學習的能力。
如果您使用分頁，請務必保持 pageSize、nextPageToken 和 offset 以外的所有欄位不變。如果這些欄位不相同，則結果中傳回的工作順序可能會不一致。
拼字檢查
拼字檢查是 CTS 搜尋要求的一項功能，其用途是找出拼寫可能有誤的搜尋字詞、更正錯誤，並依據更正後的查詢傳回結果。舉例來說，如果啟用拼字檢查功能，當求職者搜尋「manaer」，而不是「manager」時，CTS 也能傳回「manager」的相關職缺。您可以設定搜尋要求的 disableSpellCheck 欄位，啟用/停用拼字檢查。如果啟用拼字檢查，則修正的要求可在搜尋回應的 spellResult 欄位中找到。