本教程旨在引导您利用 Cloud Talent Solution 探索和开发应用。它假设您熟悉基本编程;但即使没有太多的编程知识,您也应该能够按照说明操作。完成本教程后,您应该能够借助参考文档创建自己的基本应用。 此外,还有视频教程和交互式 Codelab 可供使用。如果您有任何疑问,请与我们联系。
前提条件
您已完成以下操作:
- 如准备工作所述,完成创建和设置项目的步骤,
- 使用应用默认凭据设置好了环境,
- 基本熟悉 Java 或 Python 编程,
- 安装了最新版本的 Google API Java 客户端或 Google API Python 客户端。
创建一个公司及其职位,并搜索这些职位
本教程将为您介绍基本的 Cloud Talent Solution 应用,并引导您创建一个关联到公司资源的职位资源。下一个教程将为您介绍基于职位属性和搜索查询来搜索公司内职位的步骤。search
API 会尝试根据招聘信息中的可用字段(公司名称、职位、职位描述、职位类别、工作地点等)返回与求职者查询相关性最高的招聘信息。
创建公司
公司是与一组职位列表关联的实体。您必须先创建公司对象,才能在 Cloud Talent Solution 上发布该公司的职位。
创建公司时,您可以将任何自由格式的字符串作为 externalId
发送。这意味着您在创建和引用公司时,可以使用现有数据库(如果有)中的主键。
Go
如需了解如何安装和使用适用于 CTS 的客户端库,请参阅 CTS 客户端库。 如需了解详情,请参阅 CTS Go API 参考文档。
如需向 CTS 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Python
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
创建作业
要发布新的职位资源,您必须提供与该职位相关的所有必填字段,以及您要将此职位关联到的公司的 companyName
。在创建公司资源时,您已指定了 companyName
。
填妥职位数据的数据对象通过 POST 请求发送到 Cloud Talent Solution 端点。不应在初始请求中设置 name
字段,因为它是 createJob
API 的“仅限输出”字段:在服务器创建新的职位实体时,它是 API 响应的一部分。用于与职位资源交互的 API 端点在 Cloud Talent Solution 客户端库文档中指定。
该请求的响应是一个新的职位对象。它应包含唯一表示信息帖的职位 name
。需要更新或删除信息帖时会用到职位 name
。最佳做法是,保存此 name
并将其与您自己对该职位的唯一 ID 对应。
当您尝试创建新的职位时,如果系统中已存在另一个具有相同 companyName
、requisitionId
和 languageCode
的职位,则服务器将返回错误。
通过 Cloud Talent Solution,您还可以创建针对特定地点的职位。
如需了解详情,请参阅 locations
。
以下代码仅使用必需字段为 companyName
字段中指定的公司创建职位。
您可以使用以下代码示例创建职位。 如需了解详情,请参阅快速入门:创建公司和职位。
Go
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Java
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Python
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
使用自定义字段创建职位
Cloud Talent Solution 包含很多内置于 API 架构中的职位字段。但是,您仍然可能需要一些开箱即用选项中不存在的其他字段。虽然我们建议您尽可能使用开箱即用的字段,但 Cloud Talent Solution 还是为职位提供了一些 customAttributes
字段。这些字段可能可以过滤,也可能不可过滤。如需了解详情,请参阅 customAttributes
文档。
以下代码示例显示了如何使用 customAttribute
创建职位:
Go
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Java
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Python
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
检索职位
您可以通过 GET 操作获取职位的详细信息,以确认职位是否已创建。请注意,根据 Cloud Talent Solution 中当前创建的职位数量,新创建的职位可能需要数分钟才可检索。
您可以向 Cloud Talent Solution API 发送 GET 请求,以检索之前插入的职位的详细信息。URI 应包含原始 CREATE 请求返回的之前插入的职位 name
作为网址参数。
以下示例通过 GET 操作检索具有给定 name
的职位的详细信息:
Go
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Java
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
Python
如需详细了解如何安装和创建 Cloud Talent Solution 客户端,请参阅 Cloud Talent Solution 客户端库。
搜索职位
您已经使用 Cloud Talent Solution 创建了第一家公司和第一个职位!您现在可以对这些职位进行搜索。
更多 API
如需详细了解 API 和可用的不同配置,请参阅最新的参考文档。