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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立可直接傳送及回應訊息的 Google Chat 應用程式。

目標

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

必要條件

設定環境

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

如果範例尚未開啟,請開啟要用於此範例的 Cloud 專案:

  1. 前往 Google Cloud 控制台
  2. 按一下 Google Cloud 旁邊的向下箭頭 。畫面上會出現列出目前專案的對話方塊。
  3. 選擇您的專案並按一下 [Open] (開啟)。主控台會開啟您的專案。

開啟 Chat API

您必須先在 Google Cloud 專案中啟用 Google API,才能使用 Google 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. 查看應用程式註冊摘要。按一下「編輯」即可進行變更。 如果應用程式註冊看起來沒問題,請按一下 [返回資訊主頁]

設定指令碼

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

使用範本建立指令碼

  1. 前往 Apps Script 入門指南頁面
  2. 按一下「即時通訊應用程式」範本。您可能需要向下捲動才看得到這個範本
  3. 按一下「Untitled project」(未命名專案),輸入 Quickstart app,然後按一下 [Rename] (重新命名)

複製 Cloud 專案編號

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

設定 Apps Script 專案的 Cloud 專案

  1. 在 Chat 應用程式 Apps Script 專案中,按一下「Project Settings」圖示 專案設定的圖示
  2. 在「Google Cloud Platform (GCP) 專案」下方,點選 [變更專案]
  3. 在「GCP 專案編號」中,貼上 Google Cloud 專案編號。
  4. 按一下 [設定專案]

現在,您可以使用應用程式程式碼 (可依下列步驟所述) 試用,然後加以自訂來滿足您的需求。

請確認您在開啟 Apps Script 範本時已登入正確的 Google 帳戶。您有時可能會不經通知立即切換至預設帳戶。

建立測試部署作業

您需要此 Apps Script 專案的部署作業 ID,以便在下一個步驟中使用。

如要取得標頭部署 ID,請按照下列步驟操作:

  1. 在 Chat 應用程式 Apps Script 專案中,依序點選 [Deploy] > [Test Deployment]
  2. 複製「Head 部署作業 ID」在後續步驟中使用,然後按一下 [完成]

發布 Chat 應用程式

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

  1. Google Cloud Console 中搜尋 Google Chat API,然後按一下 [Google Chat API]
  2. 按一下 [Manage] (管理)
  3. 按一下 [設定],然後設定 Chat 應用程式:

    1. 在「App name」(應用程式名稱) 欄位中輸入 Quickstart app
    2. 在「Avatar URL」欄位中輸入 https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. 在「Description」(說明) 欄位中輸入 Quickstart app
    4. 在「Functionity」(功能) 下,選取 [Receive 1:1 messages] (接收 1:1 訊息) 和 [彙整空格和群組對話]
    5. 在「Connection settings」(連線設定) 之下,選取 [Apps Script project] (Apps 指令碼專案),並將部署 ID 貼到欄位中。
    6. 在「Permissions」(權限) 下方,選取 [特定人員和群組],然後輸入電子郵件地址。
  4. 按一下 [儲存],然後重新整理網頁。

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

  6. 按一下「儲存」

即時通訊應用程式已可回應訊息。

執行指令碼

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

感謝您新增應用程式並回應您的訊息。

後續步驟

  • 建立互動式資訊卡:卡片訊息支援已定義的版面配置、按鈕等互動式 UI 元素,以及圖片等互動式多媒體。使用資訊卡訊息來呈現詳細資訊、收集使用者資訊,並引導使用者採取後續行動。
  • 支援斜線指令:斜線指令可讓您註冊並宣傳特定的指令,使用者可透過輸入以正斜線 (/) 開頭的指令 (例如 /help) 為您的應用程式提供指令。
  • 啟動對話方塊:對話方塊是視窗式的資訊卡式介面,應用程式可開啟與使用者互動。可以依序將多張卡片合併在一起,協助使用者完成多步驟程序,例如填寫表單資料。