准备工作

概览

必须先在 Google Cloud Platform (GCP) Console 中启用 API,然后才能开始使用 Cloud Talent Solution (CTS)。以下步骤将引导您完成以下操作:

  • 在 GCP 项目上启用 CTS。
    1. 确保 CTS 已启用结算功能。
    2. 接受《数据日志记录条款及条件》。
    3. 创建一个或多个服务帐号并将其分配给 Cloud Talent Solution。
    4. 下载服务帐号凭据密钥。
  • 设置身份验证环境变量。

GCP Console 设置

  1. 转到 GCP Console。 导航到页面顶部的下拉菜单,然后选择要与 Cloud Talent Solution 相关联的 GCP 项目。如果您先前创建了一个或多个项目,则它们将显示在弹出菜单的列表中。您可以选择现有项目(所选项目旁边会显示一个对勾标记),也可以通过点击新建项目来创建新项目。如需详细了解如何创建 GCP 项目,请参阅文档

  2. 如果您创建新项目,则系统会提示您将一个结算帐号关联到该项目。如果您使用的是现有项目,请确保已启用结算功能。您可以随时访问项目的结算信息,方法是:转到主导航菜单(左上角的汉堡形图标),然后点击结算选项:

  3. 选择 GCP 项目并将其关联到结算帐号后,即可启用 Cloud Talent Solution API。转到主导航菜单,然后向下滚动到人工智能部分。点击 Talent Solution,然后从弹出的菜单中选择概览

  4. 如果您想先试用 API 而不将其与项目关联,您可以选择试用此 API 选项。如需详细了解如何使用此功能,请参阅 Job Search API Explorer 文档。要启用 Cloud Talent Solution API 与您的 GCP 项目一起使用,请点击启用

  5. 系统会显示数据日志记录页面。您必须接受条款和条件,才能使用 CTS 的所有功能。如果您选择不接受这些条款,您将只能使用删除 API 请求。点击启用

  6. 系统会提示您将一个或多个服务帐号关联到 CTS API。如果您使用的项目已经有与之关联的服务帐号,此页面上将会列出这些服务帐号。点击您要关联到 CTS API 的帐号旁边的关联。完成此操作后,您可以跳至第 8 步,以确保您已下载该帐号的 JSON 或 P12 凭据。

    如果您的项目还没有任何服务帐号,系统就会提示您创建一个。在服务帐号名称框中键入您选择的名称。您的输入将自动填充到服务帐号 ID 框中。服务帐号说明框是可选的,但如果您打算将多个服务帐号与您的项目相关联,则建议使用。在此框中输入服务帐号的简短说明,然后点击创建

  7. 在下一页面上,您将可以为新服务帐号分配角色。如需详细了解可用角色和每个角色可以拥有的权限,请参阅 CTS IAM 权限页面。点击选择角色下拉列表,然后向下滚动至 Cloud Talent Solution。您可以从右侧列的选项中为此服务帐号选择角色:

  8. 下一页为您提供了完成多项任务的选项。这些任务不是必需的,但强烈建议执行。您可以通过输入个人用户的电子邮件地址来为其授予对刚创建的服务帐号的访问权限。您也可以为服务帐号创建私钥。使用 API 时,您必须在身份验证过程中使用私钥。如果您选择不立即执行这些操作,则可以使用主导航菜单中的 IAM 选项访问服务帐号,从而随时生成密钥并添加/更改个人用户信息。

    点击创建密钥

    从弹出菜单中选择您的首选格式,然后点击创建

    系统会自动下载新的 JSON 或 P12 凭据文件。将此文件存储在特定位置,并记下文件路径。进行身份验证过程时,您需要将 GOOGLE_APPLICATION_CREDENTIALS 环境变量指向该文件。这是验证对 Cloud Talent Solution 的请求的重要步骤。

    下载凭据文件后,点击完成

  9. 您的服务帐号现在显示在关联服务帐号页面上。点击关联以将其关联到 CTS API:

  10. 现在,该帐号已关联,您可以开始将 Cloud Talent Solution 集成到系统中了:

设置身份验证环境变量

通过设定环境变量 GOOGLE_APPLICATION_CREDENTIALS,向您的应用代码提供身份验证凭据。将 [PATH] 替换为包含您服务帐号密钥的 JSON 文件的路径,并将 [FILE_NAME] 替换为文件名。此变量仅适用于当前的 shell 会话,因此,如果您打开新的会话,请重新设置该变量。

Linux 或 macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

例如:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/[FILE_NAME].json"

Windows

使用 PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

例如:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\[FILE_NAME].json"

使用命令提示符:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

如需了解详情,请参阅 GCP 身份验证文档

后续步骤

安装客户端库或查看创建职位和公司快速入门以开始进行 API 调用。