本頁面說明如何使用 Google Apps Script 建構可在 Google Chat 中運作的 Google Workspace 外掛程式。在 Google Chat 中，使用者會看到附加元件以 Google Chat 應用程式的形式顯示。詳情請參閱「擴充 Google Chat 總覽」。
Chat 應用程式可讓您直接傳送訊息和回覆，並透過重複訊息功能進行對話。
下圖顯示架構和訊息模式：
在上圖中，使用者與 Apps Script Chat 應用程式互動時，資訊會依照下列流程傳送：
- 使用者透過即時訊息或 Chat 聊天室，傳送訊息至 Chat 應用程式。
- 位於 Google Cloud 的 Chat 應用程式邏輯會接收並處理訊息，這些邏輯是透過 Apps Script 實作。
- 您可以選擇讓 Chat 應用程式邏輯整合 Google Workspace 服務，例如日曆或試算表，或是其他 Google 服務，例如 Google 地圖或 YouTube。
- Chat 應用程式邏輯會將回應傳回至 Chat 中的 Chat 應用程式服務。
- 系統會將回應傳送給使用者。
目標
- 設定環境。
- 設定指令碼。
- 為 Chat 應用程式設定 Google Workspace 外掛程式。
- 測試 Chat 應用程式。
必要條件
- 具備 Google Chat 存取權的 Google Workspace 企業或進階版帳戶。
- Google Cloud 專案。如要建立專案，請參閱「建立 Google Cloud 專案」。
設定環境
在 Google Cloud 控制台中開啟 Cloud 專案
如果尚未開啟，請開啟要用於本範例的 Cloud 專案：
- 在 Google Cloud 控制台中，前往「Select a project」頁面。
- 選取要使用的 Google Cloud 專案。或者，您也可以按一下「建立專案」，然後按照畫面上的指示操作。如果您建立 Google Cloud 專案，可能需要為專案啟用計費功能。
開啟 Chat API
使用 Google API 前，您必須先在 Google Cloud 專案中啟用這些 API。您可以在單一 Google Cloud 專案中啟用一或多個 API。在 Google Cloud 控制台中啟用 Google Chat API。
設定 OAuth 同意畫面
所有使用 OAuth 2.0 的應用程式都需要同意畫面設定。設定應用程式的 OAuth 同意畫面，即可定義向使用者和應用程式審查人員顯示的內容，並註冊應用程式，以便日後發布。
- 在 Google Cloud 控制台中，依序前往「選單」 >「API 和服務」 >「OAuth 同意畫面」。
- 在「使用者類型」部分，選取「內部」，然後按一下「建立」。
- 填寫應用程式註冊表單，然後按一下「儲存並繼續」。
目前您可以略過新增範圍，直接按一下「儲存並繼續」。日後，如果您建立的應用程式是用於 Google Workspace 機構以外的環境，就必須將使用者類型變更為外部，然後新增應用程式所需的授權範圍。
- 查看應用程式註冊摘要。如要修改資訊，請按一下「編輯」。如果應用程式註冊看起來沒問題，請按一下「返回資訊主頁」。
設定指令碼
如要設定指令碼，請複製快速入門專案，然後在 Apps 指令碼中設定 Cloud 專案。
複製快速入門專案
- 按一下下方按鈕，即可開啟 Google Chat 中的外掛程式 Apps Script 專案。
開啟專案 - 按一下 「總覽」。
- 在總覽頁面中，按一下
「建立副本」。 為 Apps 指令碼專案副本命名：
按一下「Chat 外掛程式副本」。
在「Project title」中輸入
Add-on Chat app按一下 [重新命名]。
複製 Cloud 專案編號
- 在 Google Cloud 控制台中，依序前往「Menu」(選單) >「IAM & Admin」(IAM 與管理)>「Settings」(設定)。
- 在「專案編號」欄位中複製值。
設定 Apps Script 專案的 Cloud 專案
- 在 Chat 應用程式 Apps Script 專案中，按一下「Project Settings」圖示
。 - 在「Google Cloud Platform (GCP) 專案」下方，按一下「變更專案」。
- 在「GCP 專案編號」中貼上 Google Cloud 專案編號。
- 按一下「設定專案」。
您現在擁有可運作的應用程式程式碼，可以試用 (如以下步驟所述)，然後依需求進行自訂。
開啟 Apps Script 專案時，請確認您已登入正確的 Google 帳戶。目前帳戶有時會在你不知情的情況下切換為預設帳戶。
建立測試部署
您需要這個 Apps Script 專案的部署 ID，才能在後續步驟中使用。
如要取得主部署 ID，請按照下列步驟操作：
- 在 Chat 應用程式的 Apps Script 專案中，依序按一下「Deploy」「Test deployments」。
- 複製主部署 ID，以便在後續步驟中使用，然後按一下「完成」。
設定外掛程式
使用 Apps Script 部署作業，按照下列步驟建立外掛程式並部署 Google Chat 應用程式：
- 在控制台中搜尋
Google Chat API，然後按一下「Google Chat API」。 - 按一下「管理」。
按一下「設定」，然後設定 Chat 應用程式：
- 在「App name」(應用程式名稱) 欄位中輸入
Add-on Chat app。 - 在「Avatar URL」(顯示圖片網址) 欄位中輸入
https://developers.google.com/chat/images/quickstart-app-avatar.png。 - 在「Description」欄位中輸入
Add-on Chat app。 - 在「功能」下方，選取「接收一對一訊息」和「加入聊天室和群組對話」。
- 在「連線設定」下方，選取「Apps Script 專案」。
- 在「Deployment ID」欄位中，貼上您先前複製的 Head 部署 ID。
- 在「瀏覽權限」下方，選取「僅限您網域中的特定使用者和群組」，然後輸入您的電子郵件地址。
- 在「App name」(應用程式名稱) 欄位中輸入
按一下 [儲存]。
Chat 應用程式已準備好回覆訊息。
測試 Chat 應用程式
如要測試 Chat 應用程式，請使用 Chat 應用程式開啟即時訊息聊天室並傳送訊息：
使用您新增自己為信任測試人員時提供的 Google Workspace 帳戶，開啟 Google Chat。
- 按一下 「發起即時通訊」。
- 在「新增 1 位或多位使用者」欄位中，輸入 Chat 應用程式的名稱。
從搜尋結果中選取 Chat 應用程式。即時訊息會隨即開啟。
在與應用程式互傳的新即時訊息中，輸入
Hello並按下enter。Chat 應用程式會感謝你新增這個應用程式，並回應你的訊息。
如要新增信任的測試人員，並進一步瞭解如何測試互動功能，請參閱「測試 Google Chat 應用程式的互動功能」。
疑難排解
當 Google Chat 應用程式或資訊卡傳回錯誤時，Chat 介面會顯示「發生錯誤」的訊息。或「無法處理您的要求」。有時 Chat UI 不會顯示任何錯誤訊息，但 Chat 應用程式或資訊卡會產生意外結果，例如資訊卡訊息可能不會顯示。
雖然 Chat UI 可能不會顯示錯誤訊息，但當您開啟 Chat 應用程式的錯誤記錄功能時，系統會提供說明性錯誤訊息和記錄資料，協助您修正錯誤。如需查看、偵錯及修正錯誤的相關說明，請參閱「排解及修正 Google Chat 錯誤」一文。
清除所用資源
如要避免系統向您的 Google Cloud 帳戶收取本教學課程中所用資源的相關費用，建議您刪除 Cloud 專案。
- 在 Google Cloud 控制台中前往「管理資源」頁面。依序按一下「選單」圖示 >「IAM 與管理」 >「管理資源」。
- 在專案清單中選取要刪除的專案，然後按一下「刪除」圖示 。
- 在對話方塊中輸入專案 ID，然後按一下「Shut down」(關閉) 即可刪除專案。