從舊版遷移至 CTS Job Search 4

總覽

Cloud Talent Solution v4 是最新正式發布 (GA) 的版本。 Cloud Talent Solution v4 整合了先前多個版本 (v3、v3p1beta1 和 v4beta1) 的功能。隨著 v4 的發布，所有舊版 (v3、v3p1beta1 和 v4beta1) 現已淘汰。自 2021 年 10 月 14 日起，系統將無法呼叫已淘汰的版本 (v3p1beta1、v4beta1 和 v3)。

功能是否變更

下表列出第 4 版與舊版之間的重要功能差異。如要全面瞭解功能異動，建議您參閱版本資訊。

功能異動	較舊版本	v4
支援多重租戶	從 v4beta1 開始支援。v4beta1 同時支援房客和非房客路徑。	現在必須提供租戶路徑。如要從非用戶路徑遷移至用戶路徑，請使用 listTenants API 找出用戶，並將其新增至用戶路徑。
批次作業	v3 和 v3p1beta1 中的批次作業為同步作業。v4beta1 將 BatchCreate 和 BatchUpdate 升級為非同步作業。	BatchDelete 會新增為批次作業，所有批次作業仍為非同步。
直方圖分面	v3 和 v3p1beta1 皆支援這項功能。自 v4beta1 起，系統不再支援 HistogramFacets，並改用直方圖查詢，可透過運算式提供更多彈性。	僅支援直方圖查詢 (與 v4beta1 相同)。
CompanyName	這個欄位在 v3 和 v3p1beta1 中稱為 companyName，在 v4beta1 中則重新命名為 company。	欄位名稱為 company (與 v4beta1 相同)。
requirePreciseResultSize	已在 v3、v3p1beta1 和 v4beta1 中淘汰。	已從第 4 版中刪除，因為所有搜尋呼叫現在都會傳回精確結果。
estimatedTotalSize		已從第 4 版中刪除，因為所有搜尋呼叫現在都會傳回精確結果，且這個欄位的值與 totalSize 相同。
CommuteMethod	步行和騎自行車是 v4beta1 的 Beta 版選項。這些功能將維持 Beta 版，僅適用於 v4beta1，直到 2021 年第 1 季左右，屆時這些功能就會正式發布並納入 v4。	在 2021 年第 1 季前，v4 僅提供 COMMUTE_METHOD_UNSPECIFIED、DRIVING 和 TRANSIT 這三種 CommuteMethod 選項。
SearchJobsRequest.max_page_size	在所有先前版本中稱為「SearchJobsRequest.page_size」。	在第 4 版中重新命名為 max_page_size。
SearchJobsForAlertRequest.max_page_size	在所有先前版本中稱為「SearchJobsForAlertRequest.page_size」。	在第 4 版中重新命名為 max_page_size。
Tenant.usage_type	Tenant.usage_type 欄位是在 v4beta1 中新增。	這個欄位已在第 4 版中移除，租戶內的資料只會用於提升該租戶的搜尋品質。

依版本新增的內容

如要瞭解從舊版升級至第 4 版後可獲得的全新功能，請參閱下表。舉例來說，如果您目前使用第 3 版，升級至第 4 版後，即可解鎖下列所有功能。

v3p1beta1 (包含 v3 功能)	v4p1beta1 (包含 v3p1beta1 功能)	第 4 版 (包括第 4 版 Beta 版功能)
新增直方圖運算式	依通勤時間搜尋的結果更準確	批次作業 (BatchDelete)
自訂排名	改善意見回饋機制	gRPC (必填)
Beta 版用戶端程式庫	支援多重租戶
	批次作業 (BatchCreate 和 BatchUpdate)
	gRPC (選填)

gRPC 用戶端程式庫

從 Cloud Talent Solution 第 4 版開始，系統只支援以 gRPC 為基礎的用戶端程式庫。gRPC 用戶端程式庫是高效能的 RPC 架構，可在任何環境中執行，並包含 REST 和 RPC 介面。您將取得 Cloud Talent Solution 產生的用戶端程式庫，支援多種語言 (Java、Python、Node.js、C#、PHP、Ruby)，可供使用 API。