概览
Cloud Talent Solution v4 是正式版 (GA) 的最新版本。Cloud Talent Solution v4 整合了多个先前版本（v3、v3p1beta1 和 v4beta1）的功能。随着 v4 的发布，所有先前的版本（v3、v3p1beta1 和 v4beta1）现已弃用。从 2021 年 10 月 14 日起，对已弃用的版本（v3p1beta1、v4beta1 和 v3）的调用将会失败。
功能变化
下表列出了 v4 与较低版本之间的一些关键功能变化。如需全面了解功能变化，建议您查看版本说明。
| 功能变化 | 旧版本 | v4 |
|---|---|---|
| 多租户支持 | 从 v4beta1 开始受支持。v4beta1 支持租户路径和非租户路径。 | 现在必须提供租户路径。 如需从非租户路径迁移到租户路径，请使用 listTenants API 查找租户并将其添加到租户路径。 |
| 批量操作 | v3 和 v3p1beta1 中的批量操作是同步的。v4beta1 会将 BatchCreate 和 BatchUpdate 升级到异步操作。 | BatchDelete 将作为批量操作添加，所有批量操作仍保持异步。 |
| 直方图 Facet | 在 v3 和 v3p1beta1 中受支持。从 v4beta1 HistogramFacets 开始不受支持，并替换为直方图查询，后者使用表达式提高了灵活性。 |
仅支持直方图查询（与 v4beta1 相同）。 |
CompanyName |
在 v3 和 v3p1beta1 中，该字段称为 companyName，而在 v4beta1 中，重命名为 company。 |
字段名称为 company（与 v4beta1 相同）。 |
requirePreciseResultSize |
在 v3、v3p1beta1 和 v4beta1 中已弃用。 | 已从 v4 中删除，因为所有搜索调用现在都会返回精确结果。 |
estimatedTotalSize |
已从 v4 中删除，因为所有搜索调用现在都会返回精确结果，而且此字段的值与 totalSize 相同。 |
|
CommuteMethod |
步行和骑行是 v4beta1 中的 Beta 版选项。在 2021 年第一季度左右之前，我们将仅在 v4beta1 中继续保留其 Beta 版功能，然后这些功能还将在 v4 中提供。 | 2021 年第一季度之前，v4 中仅有的 CommuteMethod 选项为 COMMUTE_METHOD_UNSPECIFIED、DRIVING 和 TRANSIT。 |
SearchJobsRequest.max_page_size |
在所有过往版本中名为 SearchJobsRequest.page_size。 |
在 v4 中重命名为 max_page_size。 |
SearchJobsForAlertRequest.max_page_size |
在所有过往版本中名为 SearchJobsForAlertRequest.page_size。 |
在 v4 中重命名为 max_page_size。 |
Tenant.usage_type |
v4beta1 中添加了 Tenant.usage_type 字段。 |
此字段已从 v4 中移除。租户中的数据仅用于提高该租户中的搜索质量。 |
不同版本的新增功能
请参阅下表，了解从旧版本升级到 v4 后您可以获得的全新功能。例如，如果您目前使用的是 v3，则可通过升级到 v4 来解锁以下所有功能。
| v3p1beta1（包括 v3 功能） | v4p1beta1（包括 v3p1beta1 功能） | v4（包括 v4beta1 功能） |
|---|---|---|
| 新的直方图表达式 | 基于通勤时间的搜索的改进 | 批量操作 (BatchDelete) |
| 自定义排名 | 反馈机制改进 | gRPC（必需） |
| Beta 版客户端库 | 多租户支持 | |
| 批量操作（BatchCreate 和 BatchUpdate） | ||
| gRPC（可选） |
gRPC 客户端库
从 Cloud Talent Solution v4 开始，仅支持基于 gRPC 的客户端库。gRPC 客户端库是可在任何环境中运行的高性能 RPC 框架，包括 REST 和 RPC 接口。您将可以获得使用不同语言（Java、Python、Nodejs、C#、PHP、Ruby）的 Cloud Talent 解决方案生成的客户端库，可以使用这些 API。