此页面由 Cloud Translation API 翻译。

配置对 Google Cloud Search API 的访问权限

您必须先配置对 Google Cloud Search API 的访问权限，然后才能直接或通过 SDK 使用此 API。本文档介绍了使用 Google Cloud Search API REST API 所需的步骤。

1. 创建 API 项目

若要启用此 API，您必须先创建一个 Google Cloud 项目。该项目构成了创建、启用和使用所有 Google Cloud 服务的基础，包括管理 API、启用结算功能、添加和移除协作者以及管理权限。

打开 Google Cloud Console。
在页面顶部，点击“Google Cloud 控制台”右侧的。此时会显示一个列出当前项目的对话框。
点击 NEW PROJECT。系统随即会显示“新建项目”界面。
在 Project Name 字段中输入项目名称。
（可选）点击修改以修改项目 ID。创建项目后，项目 ID 无法更改，因此请选择满足项目生命周期需求的 ID。
如需浏览项目的位置，请点击浏览。
点击项目所在的位置，然后点击选择。
点击创建。Console 将导航到“信息中心”页面。项目会在几分钟内创建完成。

如需详细了解如何创建和管理项目，请参阅创建和管理项目。

2. 启用 API

您需要启用 Google Cloud Search API 并创建服务账号以获取凭据。

点击 Google Cloud 控制台横幅右侧的图标并选择新创建的项目，以确保您使用的是新创建的项目。
点击启用 API 和服务。系统随即会显示“欢迎使用 API 库”页面。
导航到 Google Cloud Search API。
点击启用。系统随即会显示“概览”页面。

如需详细了解如何启用和停用 API，请参阅在 Google Cloud 控制台中管理 API

3. 创建服务账号凭据

在 Google Cloud 控制台中，点击左侧导航栏中的凭据。此时会显示“凭据”页面。
从创建凭据下拉列表中，选择服务账号。此时会显示“创建服务账号”页面。
在服务账号名称字段中输入名称。
（可选）修改服务账号 ID。
点击创建。系统随即会显示“服务账号权限”界面。
点击继续。系统随即会显示“向用户授予访问此服务账号的权限”界面。
点击创建密钥，然后点击完成。系统随即会显示一个“私钥已保存到您的计算机”对话框，并将该私钥的副本下载到您的计算机。
点击关闭。

如需详细了解服务账号，请参阅服务账号、Web 应用和已安装的应用

4. 确定电子邮件地址

在 Google Cloud 控制台中，选择您在本页面顶部创建的项目。
点击 Google Cloud 控制台横幅左侧的“导航”菜单。
点击 IAM 和管理 > 服务账号。
在列表中的“服务账号 ID”下，记下生成的电子邮件地址，该地址标识您配置的服务账号。将数据源添加到 Cloud Search 时会用到此电子邮件地址。

5. 初始化第三方支持

您必须先初始化 Google Cloud Search 的第三方支持，然后才能调用任何其他 Cloud Search API。

如需为 Cloud Search 初始化第三方支持，请执行以下操作：

您的 Cloud Search 平台项目包含服务账号凭据。不过，为了初始化第三方支持，您必须创建 Web 应用凭据。如需了解如何创建 Web 应用凭据，请参阅创建凭据。完成此步骤后，您应该会获得一个客户端 ID 和客户端密钥文件。
使用 Google 的 OAuth 2 Playground 获取访问令牌：
1. 点击“设置”，然后选中使用您自己的身份验证凭据。
2. 输入第 1 步中的客户端 ID 和客户端密钥。
3. 点击关闭。
4. 在“范围”字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击授权。OAuth 2 Playground 会返回一个授权代码。
5. 点击 Exchange authorization code for tokens。系统会返回一个令牌。

如需初始化对 Cloud Search 的第三方支持，请使用以下 curl 命令。请务必将 [YOUR_ACCESS_TOKEN] 替换为第 2 步中获取的令牌。

curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

如果成功，响应正文会包含一个 operation 实例。例如：

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

如果未能成功，请与 Cloud Search 支持团队联系。

使用 operations.get 验证第三方支持是否已初始化：

curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

第三方初始化完成后，其中包含设置为 true 的字段 done。例如：

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

后续步骤

您可以执行以下几个步骤：

如果您计划将 Google Cloud Search 与非 Google 数据代码库（例如 Microsoft® SharePoint®）搭配使用，则必须创建数据源。如需获取有关添加数据源的说明，请参阅添加可供搜索的数据源。
设置数据源后，您可以创建并注册架构，以确定 Google Cloud Search 应如何表示代码库中的数据。