GSP250

總覽

Google Chat 機器人可做為簡便的組織資料和服務存取點，使用者只要在即時通訊介面與機器人對話，就能存取所需項目。Google Chat 機器人可透過 Google Apps Script 建立。機器人還能讓您輕鬆存取其他 Google 服務，例如雲端硬碟、Gmail、日曆、文件、試算表等。

在本實驗室中，您將使用 Google Apps Script 建立簡單的 Google Chat 機器人，大致瞭解這項功能。

學習內容

在本實驗室中，您會執行下列工作：

• 使用預先填入事件處理常式的範本，建立 Chat 擴充應用程式。
• 設定並發布 Google Chat 機器人。

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

1. 點選「Start Lab」按鈕。如果實驗室會產生費用，畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的臨時憑證
   • 完成這個實驗室所需的其他資訊 (如有)

2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，選取「在無痕視窗中開啟連結」。

   接著，實驗室會啟動相關資源，並開啟另一個分頁，顯示「登入」頁面。

   提示：您可以在不同的視窗中並排開啟分頁。

   注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

   {{{user_0.username | "Username"}}}

   您也可以在「Lab Details」窗格找到 Username。

4. 點選「下一步」。

5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

   {{{user_0.password | "Password"}}}

   您也可以在「Lab Details」窗格找到 Password。

6. 點選「下一步」。

   重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

7. 按過後續的所有頁面：

   • 接受條款及細則。
   • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
   • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要使用 Google Cloud 產品和服務，請點選「導覽選單」，或在「搜尋」欄位輸入服務或產品名稱。

工作 1：使用範本建立 Chat 擴充應用程式

請使用 Chat 擴充應用程式範本建立新的 Google Apps Script 專案，來導入機器人。

注意：登入 Google Cloud 控制台會設定專案和憑證。在步驟 1 點按 Google Apps Script 編輯器連結前，務必先登入 Google Cloud 控制台。

1. 點按 Google Apps Script 首頁連結，開啟 Google Apps Script 線上編輯器。

2. 在「Google Workspace 外掛程式入門範本」下方，點選「Chat 擴充應用程式」(中繼版本)。

3. 點選「未命名專案」 (目前名稱)。

4. 在「編輯專案名稱」對話方塊中，將專案重新命名為 Friendly Bot，然後點選「重新命名」。

Google Chat 事件

Apps Script 機器人與 Google Chat 的互動大多以事件為依據。使用者、機器人和 Google Chat 之間的互動通常依序進行。

1. 使用者發起動作，例如將機器人新增至聊天室、向機器人傳送即時訊息，或從聊天室中移除機器人。
2. 該動作以 Google Chat 機器人為對象，引發事件。
3. Google Chat 呼叫機器人指令碼中定義的相應事件處理常式。

Apps Script 機器人會監聽 Google Chat 引發的四種事件：

• ADDED_TO_SPACE：真人使用者將機器人新增至聊天室或即時訊息時，會引發這個事件。您可以在 Apps Script 定義 onAddedToSpace() 函式來處理這個事件。
• REMOVED_FROM_SPACE：使用者從聊天室或即時訊息中移除機器人時，會引發這個事件。這個事件不會將回覆發布至 Google Chat。您可以在 Apps Script 定義 onRemovedFromSpace() 函式來處理這個事件。
• MESSAGE：使用者直接向機器人傳送即時訊息，或在聊天室 @提及機器人時，會引發這個事件。您可以在 Apps Script 定義 onMessage() 函式來回應這個事件。

查看 MESSAGE 事件處理常式的程式碼

Chat 擴充應用程式範本會預先填入包含事件處理常式的程式碼檔案。

• 點選 Code.gs 檔案，查看預先填入的事件處理常式。

請注意，MESSAGE、ADDED_TO_SPACE 和 REMOVE_FROM_SPACE 的事件處理常式，會執行先前提到的特定函式來完成各種工作，例如在 Google Chat 回覆使用者訊息。

使用範本建立 Chat 擴充應用程式

工作 2：發布並測試聊天機器人

執行及測試機器人前，您必須先為 Google Cloud 專案啟用 Google Chat API 並發布機器人。

在這項工作中，您將完成各個機器人發布設定步驟，包括設定 OAuth 同意畫面、更新 Apps Script 應用程式以參照適當 Google Cloud 專案，以及更新 Google Chat API 設定以發布機器人進行測試。

設定 OAuth 同意畫面

1. 點按 Google Cloud 控制台左上方的「導覽選單」()，然後依序選取「API 和服務」>「OAuth 同意畫面」。

2. 點選「開始使用」。

3. 在「專案設定」頁面的「應用程式資訊」部分，完成下列設定，然後點選「下一步」：

欄位	值
應用程式名稱	Friendly Bot
使用者支援電子郵件	從下拉式選單中選取電子郵件 ID「」。這也是實驗室操作說明左側面板中的使用者電子郵件。

4. 「目標對象」請選取「內部」，然後點選「下一步」。

5. 在「聯絡資訊」部分，提供電子郵件地址「」，然後點選「下一步」。

6. 接受政策，然後點選「繼續」。接著點選「建立」。

點選「Check my progress」確認目標已達成。

設定使用者同意畫面

找出 Google Cloud 專案編號，並將 Apps Script 應用程式更新為參照該編號

1. 前往「導覽選單」()，依序點選「Cloud 總覽」>「資訊主頁」。

2. 在資訊主頁找出「專案資訊」部分。

3. 記下專案編號，以便在下一步用來設定專案。

4. 返回 Apps Script 編輯器，然後前往 Friendly Bot 專案的「專案設定」()。

5. 點選「Google Cloud Platform (GCP) 專案」下方的「變更專案」。

6. 在「GCP 專案編號」中輸入先前複製的專案編號，接著點選「設定專案」。

設定並發布聊天機器人

1. 在 Apps Script 編輯器中，依序點選畫面右上角的「部署」>「測試部署作業」，然後點選「首要部署作業 ID」旁的「複製」，取得測試所需的首要部署作業 ID。

2. 前往 Google Cloud 控制台，依序點選「導覽選單」() >「API 和服務」>「程式庫」。

3. 在程式庫中搜尋 Google Chat API，然後從列出的搜尋結果中選取該 API。

這項專案應已啟用 Google Chat API。如果尚未啟用，請點選「啟用」。

4. 依序點選 Google Chat API 的「管理」和「設定」分頁標籤。

5. 在「設定」對話方塊中，將欄位設為下列值：

欄位	值
應用程式名稱	Friendly Bot
顯示圖片網址	https://goo.gl/kv2ENA
說明	Apps Script 實驗室機器人
功能	啟用「加入聊天室和群組對話」
連結設定	勾選「Apps Script」，然後將您在步驟 1 複製的首要部署作業 ID 貼到「部署作業 ID」方塊。
顯示設定

6. 點選「儲存」。

7. 儲存變更後，捲動至「設定」對話方塊頂端，將「應用程式狀態」更新為 LIVE – available to users。

您可能需要重新整理頁面，才能看到「應用程式狀態」欄位。如果「應用程式狀態」的值已設為 LIVE – available to users，請保留該值，然後務必在下一步再次儲存頁面。

8. 再次點選「儲存」。

測試聊天機器人

本實驗室的最後一個部分是測試 Google Chat 機器人，完成下列步驟就能進行測試！

1. 點按 Google Chat 連結，開啟 Google Chat。

2. 選取「發起即時通訊」。

3. 搜尋 Friendly bot。

4. 從搜尋結果中選取您建立的 Friendly Bot (Apps Script 實驗室機器人)，展開即時通訊。

開啟即時訊息串後，您應該會看到機器人傳送訊息，感謝您將其新增至即時訊息：

Thank you for adding me to a direct message, student XXXXX!

這則回覆是由 onAddedToSpace 函式發起，用來回應這個「機器人加入 Chat 聊天室」事件。

5. 最後對機器人輸入訊息，例如「Hello bot!」。

您應會看到機器人重複您的訊息，例如：

You said "Hello bot!"

這則回覆是由 onMessage 函式發起，用來回應這個「使用者即時向機器人傳送訊息」事件。

恭喜！

您快速建立了 Google Chat 機器人來回覆使用者訊息！

後續步驟/瞭解詳情

• 瞭解 Workspace 的其他用途：
  • Google Apps Script：以 4 行程式碼存取 Google 試算表、地圖和 Gmail
• 查看其他實用資源：
  • Google Chat 說明文件網站
  • Apps Script 機器人快速入門導覽課程
  • 建立新機器人
  • 發布機器人
  • 建立互動式資訊卡
  • 資訊卡參考資料
  • 事件物件參考資料
  • Gmail 進階服務參考資料
  • Calendar Apps Script API 參考資料
  • Google Workspace 學習中心

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法，讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程，並有隨選、線上和虛擬課程等選項，方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

使用手冊上次更新日期：2025 年 8 月 18 日

實驗室上次測試日期：2025 年 8 月 18 日

Copyright 2026 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。