本教學課程說明如何部署簡單的 Cloud Search 解決方案,並使用 GitHub 做為要建立索引的資料存放區。具體來說,本教學課程包含兩個範例應用程式:
- 使用 Cloud Search Connector SDK 建立的內容連接器,用於為 GitHub 存放區中的資料建立索引。索引資料包括問題、提取要求,以及預設分支 (master) 的開頭內容。
- 使用搜尋小工具提供自訂搜尋介面的網路應用程式。
必要條件
本教學課程需要符合下列必要條件:
- 管理員有權存取已啟用第三方資料索引的 Google Workspace 或 Cloud Identity 網域。如果無法在管理控制台中查看設定,請與網域管理員聯絡,或註冊 Cloud Search。
- GitHub 使用者帳戶。
- 熟悉 Java 和 JavaScript。
- Java 8 以上版本。
- Maven。
- Node.js 8.11 以上版本。
建立教學課程專案
首先,您必須建立 Google Cloud Platform 專案。這個專案是建立、啟用及使用所有 Google Cloud Platform (GCP) 服務的基本要件,例如管理 API、啟用計費功能、新增與移除協作者,以及管理權限。
- 開啟 Google Cloud 控制台。 
- 按一下頁面頂端的「Google Cloud 控制台」右側的 。畫面上會顯示列出目前專案的對話方塊。 
- 按一下「NEW PROJECT」(新專案)。畫面上會顯示「New Project」畫面。 
- 在「Project Name」欄位中輸入專案名稱,例如「SearchTutorial」。 
- (選用) 按一下「編輯」即可編輯專案 ID。專案建立後就無法變更專案 ID,因此請選用符合您在整個專案執行期間需求的 ID。 
- 如要瀏覽專案的位置,請按一下「瀏覽」。 
- 按一下專案位置,然後按一下「選取」。 
- 按一下「建立」。控制台會前往「資訊主頁」頁面。專案會在幾分鐘內建立完成。 
如要進一步瞭解如何建立及管理專案,請參閱「建立及管理專案」。
啟用 API
您必須啟用 Google Cloud Search API 並建立服務帳戶,才能取得憑證。
- 在左側導覽列中,按一下「API 和服務」。
- 如要確認您位於新建立的專案中,請按一下 Google Cloud 控制台橫幅右側的 圖示,然後選取新建立的專案。
- 按一下「啟用 API 和服務」。系統會顯示「歡迎使用 API 程式庫」頁面。
- 在搜尋欄位中輸入「Cloud Search API」,然後按下 Enter 鍵。系統會傳回 API 清單。
- 按一下「Cloud Search API」。畫面上會顯示「Cloud Search API」頁面。
- 按一下「啟用」。系統隨即會顯示「總覽」頁面。
如要進一步瞭解如何啟用及停用 API,請參閱「在 Google Cloud 控制台中管理 API」。
複製教學課程存放區
如要複製範例存放區,請執行下列指令:
git clone https://github.com/googleworkspace/cloud-search-samples.git