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

建立 Google Chat 應用程式，方便您直接回覆訊息及回覆訊息。

目標

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

必要條件

設定環境

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

如果此專案尚未開啟，請開啟您打算用於這個範例的 Cloud 專案：

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

    選取 Cloud 專案

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

啟用 Chat API

您必須先在 Google Cloud 專案中啟用 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. 輸入您的電子郵件地址和任何其他獲得授權的測試使用者，然後按一下「Save and continue」(儲存並繼續)。
  6. 查看應用程式註冊摘要。如要變更，請按一下「編輯」。如果應用程式註冊看起來沒問題，請按一下「返回資訊主頁」。

設定指令碼

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

使用範本建立指令碼

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

複製 Cloud 專案編號

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

設定 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 deploy」(測試部署作業)。
  2. 複製「Head Deployment ID」，用於後續步驟，然後按一下「Done」。

發布即時通訊應用程式

透過 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. 在「連線設定」下，選取「Apps Script 專案」，並將部署作業 ID 貼到欄位中。
    6. 請在「Permissions」(權限) 下方，選取「特定使用者和群組」欄位，然後輸入您的電子郵件地址。

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

  5. 在設定頁面的「App status」(應用程式狀態) 下方，將狀態設為「Live - available for users」(可對使用者啟用)。

  6. 按一下「儲存」。

即時通訊應用程式已準備好回覆訊息。

執行指令碼

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

感謝你新增應用程式，並對訊息進行回覆。

後續步驟

  • 建立互動式資訊卡：資訊卡支援定義的版面配置、互動式 UI 元素 (例如按鈕)，以及圖片等互動式多媒體。您可以使用資訊卡訊息來呈現詳細資訊、收集使用者資訊，並引導使用者進行下一個步驟。
  • 支援斜線指令：斜線指令可讓您註冊及宣傳使用者可使用的特定指令，方法是輸入以正斜線 (/) 開頭的指令 (例如 /help)。
  • 「Launch 對話」對話方塊：對話方塊會顯示視窗式介面，可讓應用程式開啟，藉此與使用者互動。可將多個資訊卡依序堆疊在一起，協助使用者完成多步驟程序 (例如填寫表單表單)。