本頁面由 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 控制台。
按一下頁面頂端的「Google Cloud 控制台」右側的。畫面上會顯示列出目前專案的對話方塊。
按一下「NEW PROJECT」(新專案)。畫面上會顯示「New Project」(新專案) 畫面。
在「專案名稱」欄位中輸入專案名稱。
(選用) 按一下「編輯」即可編輯專案 ID。專案建立後就無法變更專案 ID，因此請選用符合您在整個專案執行期間需求的 ID。
如要瀏覽專案的位置，請按一下「瀏覽」。
按一下專案位置，然後按一下「選取」。
按一下「建立」，控制台會前往「資訊主頁」頁面。專案會在幾分鐘內建立完成。

如要進一步瞭解如何建立及管理專案，請參閱「建立及管理專案」。

2. 啟用 API

您必須啟用 Google Cloud Search API 並建立服務帳戶，才能取得憑證。

如要確認您位於新建立的專案中，請按一下 Google Cloud 控制台橫幅右側的圖示，然後選取新建立的專案。
按一下「啟用 API 和服務」。系統會顯示「歡迎使用 API 程式庫」頁面。
前往 Google Cloud Search API。
點選「Enable」(啟用)。系統隨即會顯示「總覽」頁面。

如要進一步瞭解如何啟用及停用 API，請參閱「在 Google Cloud 控制台中管理 API」。

3. 建立服務帳戶憑證

在 Google Cloud 控制台中，按一下左側導覽列中的「憑證」。系統隨即會顯示「憑證」頁面。
在「建立憑證」下拉式清單中，選取「服務帳戶」。系統會顯示「建立服務帳戶」頁面。
在「Service account name」(服務帳戶名稱) 欄位中輸入名稱。
(選用) 編輯服務帳戶 ID。
按一下「建立」，畫面上會顯示「服務帳戶權限」。
按一下「繼續」。系統會顯示「將這個服務帳戶的存取權授予使用者」畫面。
按一下「建立金鑰」，然後按一下「完成」。系統會顯示「已將私密金鑰儲存至您的電腦中」對話方塊，並將私密金鑰副本下載到您的電腦。
點選「關閉」。

如要進一步瞭解服務帳戶，請參閱「服務帳戶、網頁應用程式和已安裝的應用程式」一文。

4. 找出電子郵件地址

在 Google Cloud 控制台中，選取您在頁面頂端建立的專案。
按一下 Google Cloud 控制台橫幅左側的導覽選單。
依序點選「IAM 與管理」 >「服務帳戶」。
在清單中，記下「服務帳戶 ID」下方產生的電子郵件地址，這個地址會識別您設定的服務帳戶。將資料來源新增至 Cloud Search 時，系統會使用這個電子郵件地址。

5. 初始化第三方支援

您必須先初始化 Google Cloud Search 的第三方支援，才能呼叫任何其他 Cloud Search API。

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

您的 Cloud Search 平台專案包含服務帳戶憑證。不過，為了初始化第三方支援，您必須建立 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 應如何呈現存放區中的資料。