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

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

1. 创建 API 项目

若要启用此 API，请先创建一个 Google Cloud 项目。此项目是使用 Google Cloud 服务、管理 API 和设置权限的基础。

  1. 打开 Google Cloud 控制台。
  2. 点击“Google Cloud 控制台”右侧的项目下拉菜单，然后选择新建项目 。
  3. 在项目名称 字段中输入一个名称。
  4. （可选）点击修改 以更改项目 ID。创建后，您无法更改此 ID。
  5. 点击浏览 以选择一个位置，然后点击选择 。
  6. 点击创建 。项目通常会在几分钟内准备就绪。

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

2. 启用 API

启用 Cloud Search API，并创建一个服务账号来获取凭据。

  1. 从 Google Cloud 控制台横幅中的下拉菜单中选择您的新项目。
  2. 点击启用 API 和服务 。
  3. 搜索并选择 Google Cloud Search API。
  4. 点击启用 。

如需了解详情，请参阅 在 Google Cloud 控制台中管理 API。

3. 创建服务账号凭据

  1. 在 Google Cloud 控制台中，点击左侧导航栏中的 凭据。
  2. 从创建凭据 下拉菜单中选择服务账号 。
  3. 在服务账号名称 字段中输入名称。
  4. （可选）修改服务账号 ID。
  5. 点击创建并继续 。
  6. 点击完成 以进入“服务账号”列表。
  7. 点击新服务账号的电子邮件地址，然后选择密钥 标签页。
  8. 依次点击添加密钥 > 创建新密钥 。
  9. 选择 JSON ，然后点击创建 。私钥会下载到您的计算机。

如需了解详情，请参阅 服务账号。

4. 确定服务账号电子邮件地址

  1. 在 Google Cloud 控制台中，选择您的 项目。
  2. 依次点击导航菜单 > IAM 和管理 > 服务账号 。
  3. 记下您的服务账号的电子邮件地址。您需要此地址才能将数据源添加到 Cloud Search。

5. 初始化第三方支持

在调用任何其他 Cloud Search API 之前，请先初始化 Google Cloud Search 的第三方支持。

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

  1. 在 Cloud Search 平台项目中创建 Web 应用凭据。请参阅 创建凭据。您需要客户端 ID 和客户端密钥。
  2. 使用 OAuth 2.0 Playground获取访问令牌：
    1. 点击 OAuth 2.0 配置 （设置图标），然后选中使用您自己的 OAuth 凭据 。
    2. 输入您的客户端 ID 和客户端密钥。
    3. 在“范围”字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击授权 API 。
    4. 点击 Exchange authorization code for tokens 。

  3. 运行以下 curl 命令，将 [YOUR_ACCESS_TOKEN] 替换为您的令牌：

    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。 如果失败，请与 Cloud Search 支持团队联系。

  4. 使用 operations.get 验证初始化：

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    当 done 为 true 时，初始化完成。

后续步骤

  1. 如需将 Cloud Search 与非 Google 存储区（例如 Microsoft® SharePoint®）搭配使用，您必须创建一个数据源。请参阅 添加可供搜索的数据源。
  2. 设置数据源后， 请创建并注册架构， 以确定 Cloud Search 如何表示您的数据。