Cloud Talent Solution 可讓使用者搜尋您儲存於 Cloud Talent Solution 索引中的職缺。本說明文件將帶您逐步瞭解 Cloud Talent Solution 的各種搜尋功能及相關服務。
搜尋要求
如要提出職缺搜尋要求，請將 POST 要求傳送至 jobs:search 端點，在要求主體中傳送搜尋資料。
必填欄位
以下是必填欄位：
searchMode：指定要套用的職缺搜尋類型。以下是可用選項：JOB_SEARCH：這是預設的搜尋模式，我們建議您使用這個模式。 所有職缺都會依據此模式進行搜尋，然後根據與搜尋查詢相關的程度，按順序傳回最相關的職缺。FEATURED_JOB_SEARCH：僅搜尋promotionValue大於 0 的職缺。promotionValue的值越高，在結果中的位置就會越前面；如果有相同的值，則會使用關聯性來決定位置。詳情請參閱精選職缺。
常用欄位
JobQuery：指定要比對的職缺條件，包括地點、職缺類別、聘僱類型、文字查詢、公司等。詳情請參閱「搜尋篩選器」。requestMetadata：包含此搜尋要求的使用者和工作階段資訊。詳情請參閱「RequestMetadata」。jobView：定義每個相符職缺傳回的欄位數量。可為JOB_VIEW_SMALL(預設)、JOB_VIEW_MINIMAL或JOB_VIEW_FULL。如要瞭解各選項的說明，請參閱JobView參考資料。orderBy：傳回職缺的排序順序。如要瞭解允許的值，請參閱參考資料。預設會按關聯性遞減排序 (RELEVANCE_DESC)。
放寬關聯性門檻以及地點/類別
如要讓搜尋傳回更多職缺，您可用下列兩個欄位來放寬關聯性限制：
enableBroadening：將此欄位設為true即可放寬搜尋要求的地點和職缺類別限制，以傳回更多結果。舉例來說，如果搜尋要求指定華盛頓州某個鎮半徑 2 英里內的職缺，將此標記設為true可能也會傳回華盛頓州鄰鎮的職缺。disableKeywordMatch：此標記預設為 false。將此標記設為 false 可讓 Cloud Talent Solution 在傳回與搜尋查詢有關的職缺時，也傳回職稱或描述與查詢字串完全相符的職缺。
RequestMetadata
每個搜尋和直方圖要求都應包含一個 RequestMetadata 物件。此物件包含使用者啟動搜尋的相關資訊。
以下是此物件之所以重要的幾個原因：
使用者一致性。Cloud Talent Solution 同時執行幾個版本的基礎模型，致力改善搜尋關聯性。填寫此欄位可確保求職者擁有一致的體驗。Cloud Talent Solution 可確保求職者 (透過 userId、sessionId 和 domain 識別) 擁有一致的體驗。注意：這些欄位應模糊處理。
搜尋改善。微調演算法是根據
RequestMetadata欄位所提供的資訊，以及您提供的求職者資料。這會改善搜尋結果關聯性。
搜尋運算子
| 運算子 | 說明 |
|---|---|
| ( ) | 將一或多個關鍵字組合在一起。 |
| AND | 搜尋與運算子兩側的關鍵字或關鍵字群組相關的結果。 |
| OR | 搜尋與運算子任一側的關鍵字或關鍵字群組相關的結果。 |
| NOT | 排除運算子後方括弧內的關鍵字或關鍵字群組的相關結果。 |
| - | 排除附加於運算子的關鍵字或關鍵字群組的相關結果。 |
例如：
"software OR java"會傳回中繼資料含有「software」或「java」的職缺。"software" -java會傳回與「software」相關但排除與「java」相關的職缺。"(software OR java) AND (marketing)"會傳回與「software」和「marketing」相關的職缺，以及與「java」和「marketing」相關的職缺。
求職者查詢
系統也可以將搜尋字詞做為實際的職缺相關實體進行偵測。舉例來說，如果查詢的是「實習」，Cloud Talent Solution 會將此視為「實習」的聘用類型，並篩選出 EMPLOYMENT_TYPE 為「實習」的工作。因此，即使職缺說明中必須包含「實習生」，如果該職缺的聘僱類型設為其他類型，系統也不會傳回該職缺。
疑難排解
每個搜尋要求都會在我們的系統中產生一個唯一的搜尋 requestID，可用來追蹤該搜尋的參數及回應。這對於解決與特定搜尋、CRUD 要求相關的問題相當重要，請妥善記錄。系統會將 requestId 傳回到搜尋回應主體中的 ResponseMetadata 欄位，或是相關的 CRUD 呼叫回應物件。
如有關聯性、搜尋查詢、索引查詢等相關支援問題需要協助，請向我們的支援團隊提交支援要求，並提供或要求提供相關要求 ID。
結果計數
顯示結果計數的目的是讓求職者看到系統傳回多少筆搜尋結果。這個數字不一定能夠對應直方圖結果或實際傳回的職缺數量。Job Search 最多會傳回 5000 個職缺。
分頁
預設情況下，工作搜尋每頁會傳回 100 項結果 (如果結果總數少於 100 項，則會傳回較少的結果)。您可以使用與此功能相關的欄位來加入分頁。
pageSize：每頁傳回的結果數量。nextPageToken：所傳回的搜尋結果每頁都會有不重複的符記，這個符記可指定結果下一頁的起始位置。如果沒有其他結果，則這個欄位會留空。offset：指定在頁面頂端傳回的職缺關聯性排名與 1 (傳回職缺中關聯性最高的職缺) 之間的位移。例如，使用者執行搜尋，將pageSize設定為 10。在第一頁的頁面頂端傳回 #1 的職缺，因此此頁的offset值為 0。下一頁的頁面頂端傳回 #11 的職缺，因此此頁的offset值為 10。
請將頁面大小設定為 20 項結果或更少，以避免發生延遲問題。 最佳做法為，在每個頁面發出分別的搜尋呼叫，再顯示給求職者。而不是使用單一搜尋呼叫傳回大量職缺，再在用戶端分頁，因為這會影響機器學習模型透過 Jobs Analytics Framework 準確學習的能力。
拼字檢查
拼字檢查是 Cloud Talent Solution 搜尋要求的一項功能，用途是找出拼寫可能有誤的搜尋字詞、更正錯誤，並依據更正後的查詢傳回結果。舉例來說，如果啟用拼字檢查功能，當求職者搜尋「manaer」，而不是「manager」時，Cloud Talent Solution 也能傳回「manager」的相關職缺。您可以設定 JobQuery 的 disableSpellCheck 欄位，啟用/停用拼字檢查。如果啟用拼字檢查功能，則可在搜尋回應的 spellResult 欄位中找到更正後的查詢。