設定 Google Cloud Search API 存取權

如要直接使用 Google Cloud Search API 或透過 SDK 使用，請先設定存取權。本文說明 Cloud Search API REST API 的必要步驟。

1. 建立 API 專案

如要啟用 API，請先建立 Google Cloud 專案。這個專案是使用 Google Cloud 服務、管理 API 和設定權限的基礎。

開啟 Google Cloud 控制台。
按一下「Google Cloud 控制台」右側的專案下拉式選單，然後選取「新增專案」。
在「專案名稱」欄位中輸入名稱。
(選用) 按一下「編輯」，即可變更專案 ID。建立後就無法變更。
按一下「瀏覽」選擇位置，然後按一下「選取」。
按一下「建立」，專案通常會在幾分鐘內準備就緒。

詳情請參閱「建立及管理專案」。

2. 啟用 API

啟用 Cloud Search API 並建立服務帳戶，以取得憑證。

在 Google Cloud 控制台橫幅的下拉式選單中，選取新專案。
按一下 [ENABLE APIS AND SERVICES] (啟用 API 和服務)。
搜尋並選取「Google Cloud Search API」。
按一下「啟用」。

詳情請參閱「在 Google Cloud 控制台中管理 API」。

3. 建立服務帳戶憑證

在 Google Cloud 控制台中，按一下左側導覽列中的「憑證」。
從「建立憑證」下拉式選單中選取「服務帳戶」。
在「Service account name」(服務帳戶名稱) 欄位中輸入名稱。
(選用) 編輯服務帳戶 ID。
按一下 [建立並繼續]。
按一下「完成」，即可前往「服務帳戶」清單。
按一下新服務帳戶的電子郵件，然後選取「金鑰」分頁標籤。
依序點選「新增金鑰」 >「建立新的金鑰」。
選取「JSON」，然後按一下「建立」。私密金鑰會下載到您的電腦。

詳情請參閱服務帳戶。

4. 找出服務帳戶電子郵件地址

在 Google Cloud 控制台中，選取您的專案。
依序點選「導覽選單」>「IAM 與管理」>「服務帳戶」。
記下服務帳戶的電子郵件地址。您需要這個 ID，才能將資料來源新增至 Cloud Search。

5. 初始化第三方支援

在呼叫任何其他 Cloud Search API 之前，請先初始化 Google Cloud Search 的第三方支援功能。

如要初始化第三方支援，請按照下列步驟操作：

在 Cloud Search 平台專案中建立網頁應用程式憑證。請參閱「建立憑證」。您需要用戶端 ID 和用戶端密鑰。
使用 OAuth 2.0 Playground 取得存取權杖：
1. 按一下「OAuth 2.0 Configuration」(OAuth 2.0 設定) (設定圖示)，然後勾選「Use your own OAuth credentials」(使用自己的 OAuth 憑證)。
2. 輸入用戶端 ID 和用戶端密鑰。
3. 在範圍欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings，然後按一下「Authorize APIs」(授權 API)。
4. 這時請按一下 [Exchange authorization code for tokens]。

執行下列 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 支援團隊。

使用 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 時，初始化作業即完成。

後續步驟

如要將 Cloud Search 與 Microsoft® SharePoint® 等非 Google 存放區搭配使用，必須建立資料來源。請參閱「在搜尋功能中新增資料來源」。
設定資料來源後，請建立及註冊架構，指出 Cloud Search 應如何呈現資料。