Google Apps Script Chat 應用程式快速入門導覽課程

建立 Google Chat 應用程式，這個應用程式可直接透過訊息回覆訊息並進行回應。

目標

  • 設定環境。
  • 設定指令碼。
  • 發布應用程式。
  • 執行指令碼。

必要條件

設定環境

在 Google Cloud 控制台中開啟 Cloud 專案

如果尚未開啟，請開啟要在此範例使用的 Cloud 專案：

  1. 在 Google Cloud 控制台中，前往「Select a project」(選取專案) 頁面。

    選取 Cloud 專案

  2. 選取要使用的 Google Cloud 專案。或者，按一下「建立專案」，然後按照畫面上的指示操作。如要建立 Google Cloud 專案，您可能需要開啟專案的計費功能。

啟用 Chat API

使用 Google API 前，您必須在 Google Cloud 專案中啟用 API。您可以在單一 Google Cloud 專案中啟用一或多個 API。

  • 在 Google Cloud 控制台中啟用 Google Chat API。

    啟用 API

凡是使用 OAuth 2.0 的應用程式都必須提供同意畫面設定。設定應用程式的 OAuth 同意畫面，即可定義向使用者顯示的內容和應用程式審查者，並註冊應用程式，以供日後發布。

  1. 在 Google Cloud 控制台中，依序點選「選單」圖示 >「API 和服務」>「OAuth 同意畫面」。

    前往 OAuth 同意畫面

  2. 選取應用程式的使用者類型，然後按一下「建立」。
  3. 填寫應用程式註冊表單，然後按一下「儲存並繼續」。

  4. 您現在可以略過新增範圍的步驟，然後按一下「儲存並繼續」。 日後如果您建立的應用程式供 Google Workspace 機構外部使用，就必須新增並驗證應用程式所需的授權範圍。

  5. 如果您將使用者類型設為「外部」，請新增測試使用者：
    1. 在「測試使用者」下方，按一下「新增使用者」。
    2. 輸入您的電子郵件地址和其他任何獲得授權的測試使用者，然後按一下 [儲存並繼續]。
  6. 查看應用程式註冊摘要。如要修改資訊，請按一下「編輯」。如果應用程式註冊看起來沒問題，請按一下「Back to Dashboard」(返回資訊主頁)。

設定指令碼

如要設定指令碼，請使用範本，然後在 Apps Script 中設定 Cloud 專案。

使用範本建立指令碼

  1. 前往 Apps Script 的「Get Started」頁面。
  2. 按一下「Chat 應用程式」範本。您可能需要向下捲動才能看到這個範本。
  3. 按一下「Untitled project」，輸入 Quickstart app，然後按一下「Rename」。

複製 Cloud 專案編號

  1. 在 Google Cloud 控制台中，前往您的 Cloud 專案。
  2. 依序按一下「設定」和「公用程式」圖示 >「專案設定」。
  3. 複製專案編號。

設定 Apps Script 專案的 Cloud 專案

  1. 在 Chat 應用程式指令碼專案中，按一下「Project Settings」圖示 專案設定圖示。
  2. 在「Google Cloud Platform (GCP) 專案」下方，按一下「變更專案」。
  3. 在「GCP 專案編號」中，貼上 Google Cloud 專案編號。
  4. 按一下「設定專案」。

現在，您已擁有可試用的應用程式程式碼，可試用 (如下列步驟所述)，然後根據需求進行自訂。

開啟 Apps Script 範本時，請確定您登入的是正確的 Google 帳戶。目前帳戶有時可能會在您未通知的情況下切換為預設帳戶。

建立測試部署作業

您需要這個 Apps Script 專案的部署 ID，以便在下一個步驟中使用。

如要取得頭部部署作業 ID，請執行下列步驟：

  1. 在 Chat 應用程式指令碼專案中，依序點選「Deploy」(部署) >「Test deployment」(測試部署作業)。
  2. 複製可在後續步驟中使用的標頭部署 ID，然後按一下「Done」(完成)。

發布 Chat 應用程式

從 Google Cloud 控制台發布 Chat 應用程式。

  1. 在 Google Cloud 控制台中搜尋 Google Chat API，然後按一下「Google Chat API」。
  2. 按一下 [Manage] (管理)。

  3. 按一下「Configuration」，然後設定 Chat 應用程式：

    1. 在「App name」(應用程式名稱) 欄位中輸入 Quickstart app。
    2. 在「Avatar URL」欄位中，輸入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    3. 在「Description」(說明) 欄位中輸入 Quickstart app。
    4. 在「功能」下方，選取「接收 1:1 訊息」和「加入聊天室和群組對話」。
    5. 在「Connection settings」(連線設定) 下方選取「Apps Script project」，然後將 Deployment ID 貼到欄位中。
    6. 在「Permissions」(權限) 下方，選取「specific users and groups in your domain」(在您的網域中特定使用者和群組)，然後輸入您的電子郵件地址。

  4. 按一下「儲存」並重新整理頁面。

  5. 在設定頁面的「App status」下方，將狀態設為「Live - available to users」。

  6. 按一下「儲存」。

Chat 應用程式已準備好回覆訊息。

執行指令碼

  1. 開啟 Chat。
  2. 依序按一下「發起即時通訊」圖示 >「尋找應用程式」，傳送新的即時訊息給應用程式。
  3. 在「尋找應用程式」頁面上搜尋 Quickstart App。
  4. 按一下「快速入門應用程式」旁邊的 [Chat]。
  5. 開啟與應用程式互傳的新即時訊息，輸入 Hello，然後按下 enter 鍵。

感謝你新增這個應用程式，應用程式會回應你的訊息。

後續步驟

  • 建立互動式資訊卡：支援已定義版面配置、互動式 UI 元素 (例如按鈕)，以及圖片 (例如圖片)。利用資訊卡訊息顯示詳細資訊、收集使用者的資訊，並引導使用者採取下一步。
  • 支援斜線指令：斜線指令可讓您輸入及通知使用者可透過應用程式取得的特定指令，方法是輸入以正斜線 (/) 開頭的指令，例如 /help。
  • LaunchDialogs (啟動對話方塊) - 對話方塊是視窗式的卡片介面，應用程式可開啟這些介面與使用者互動。多張資訊卡可以依序合併，有助於使用者完成多步驟的程序，例如填寫表單資料。