設定 Google Chat API

您建立的每個 Google Chat 應用程式，都需要有自己的 Google Cloud 專案，並啟用及設定 Chat API。

如要使用使用者驗證執行唯讀 API 呼叫 (例如取得即時通訊空間和列出訊息)，只要啟用 API 並建立 OAuth 用戶端即可。

如要執行建立、更新和刪除 API 呼叫，或部署及測試互動式 Chat 擴充應用程式 (建構為擴充 Chat 的 Google Workspace 外掛程式)，您也必須設定 Chat API。您可以在 Chat API 設定中指定 Chat 應用程式的所有詳細資料，包括顯示名稱、大頭貼、部署端點和互動式功能。

必要條件

• 公司或企業專用 Google Workspace 帳戶，且可存取 Google Chat。
• 建立 Google Cloud 專案。
• 設定 OAuth 同意畫面。
• 啟用 Google Chat API。

選擇 Chat 應用程式的顯示名稱、顯示圖片和說明

啟用 Chat API 後，您可以在 Chat 中設定向使用者顯示的 Chat 應用程式詳細資料，包括顯示名稱、顯示圖片和說明。這些詳細資料只會顯示在 Chat 中。如要將 Chat 擴充應用程式發布至 Marketplace，您也必須指定 Chat 擴充應用程式Marketplace 資訊中顯示的詳細資料。

設定 Chat 應用程式前，請先備妥下列資訊：

欄位	說明	格式
應用程式名稱	Chat 應用程式的顯示名稱。	最多 25 個半形英數字元
顯示圖片網址	顯示為 Chat 應用程式顯示圖片的圖片。	指向正方形圖像 (PNG 或 JPEG) 的 HTTPS 網址。 建議大小為 256 x 256 像素以上。
說明	簡短說明 Chat 應用程式的用途。	最多 40 個英數字元

Chat 應用程式的名稱、顯示圖片和說明會顯示在 Chat 使用者介面中。對於部分 Chat API 寫入要求，Chat 會使用這項資訊，將 Chat 應用程式在 Chat 中執行的動作歸因於該應用程式。

舉例來說，如果您呼叫 spaces.create() 方法，Chat 會在聊天室建立者的說明中加入 Chat 應用程式的名稱，如下圖所示：

圖 1. 使用 spaces.create() 方法代表使用者建立聊天室時，Chat 顯示的出處訊息。

如要與 Chat 擴充應用程式互動，使用者也可以透過下列方式查看或使用這項資訊：

• 使用 @ 提及即時通訊應用程式，將其加入聊天室或傳送訊息給該應用程式。
• 找出並開始與 Chat 應用程式互傳即時訊息。 在「應用程式」選單中，即時訊息會顯示 Chat 應用程式的名稱和顯示圖片。
• 使用者可以在撰寫列中瀏覽 Chat 應用程式，並查看應用程式名稱、顯示圖片和說明。

在 Google Cloud 控制台中設定 Chat 應用程式

取得 Chat 應用程式詳細資料後，開啟雲端專案並設定 Chat API：

1. 前往 Google Cloud 控制台的 Chat API 頁面，然後按一下「Configuration」(設定) 頁面：

   前往 Chat API 設定頁面

2. 在「應用程式資訊」下方，填寫「應用程式名稱」、「虛擬人偶網址」和「說明」欄位。

3. 在「互動式功能」下方，設定 Chat 應用程式是否要回應使用者互動：

   注意： 如果您的 Chat 應用程式只會呼叫 Chat API，不會接收或回應使用者互動，請將「啟用互動功能」保持關閉，然後跳至下一個步驟。

   如要建構互動式 Chat 應用程式，請開啟「啟用互動功能」，然後完成下列步驟：

   1. 在「功能」下方：
      • 選用：選取「支援應用程式首頁」，在與 Chat 擴充應用程式的 1 對 1 即時訊息中，顯示「首頁」分頁的首頁資訊卡。
      • 選取「加入聊天室和群組對話」，即可安裝及使用 Chat 應用程式。根據預設，使用者可以在使用者與 Chat 應用程式之間的專屬聊天室中，安裝 Chat 應用程式並傳送訊息。使用者也可以在有多人的聊天室中新增 Chat 應用程式並與之互動。

   2. 在「連線設定」下方，選取要用來接收 Chat 事件物件的架構：

      • 如要使用 HTTP 服務，請選取「HTTP 端點網址」並提供網址。
      • 如要使用 Google Apps Script 專案，請選取「Apps Script」，並提供專案的部署作業 ID。
      • 如要使用 Dialogflow 虛擬服務專員，請選取「Dialogflow」，然後選取「Dialogflow CX」或「Dialogflow ES」，並提供虛擬服務專員的資源名稱。
      • 如要使用 Pub/Sub，請選取「Cloud Pub/Sub」並輸入主題名稱。
      警告： 如果已填入 Apps Script 部署作業 ID，表示雲端專案已連結至現有的 Google Workspace 外掛程式。如果您在 Chat API 中更新部署作業 ID，外掛程式的部署作業 ID 也會更新，這可能會影響您在 Google Workspace Marketplace 中的商家資訊。如要查看外掛程式設定，請參閱「在 Google Workspace Marketplace SDK 中設定應用程式」。

   3. 選用：如要將事件物件傳送至特定端點或函式，請依序前往「連線設定」>「觸發條件」，然後為下列即時通訊觸發條件提供或更新回呼端點或函式：

      注意： 如果是 Apps Script，如未更新觸發條件，就必須實作這個部分填入的預設回呼函式 (例如 onMessage、onAddedToSpace、onRemovedFromSpace、onAppCommand 和 onAppHome)。
      • 應用程式首頁 (如果已啟用「支援應用程式首頁」)：使用者在與 Chat 應用程式互傳的個人即時訊息中開啟「首頁」分頁。
      • 加入聊天室：使用者將 Chat 應用程式加入群組對話或聊天室，或為 1:1 訊息安裝 Chat 應用程式。
      • 訊息：使用者傳送訊息給 Chat 應用程式。舉例來說，使用者傳送即時訊息給 Chat 應用程式，或在有多位使用者的聊天室中 @提及 Chat 應用程式。
      • 從聊天室中移除：使用者從聊天室解除安裝或移除 Chat 應用程式。
      • 應用程式指令：使用者從 Chat 應用程式叫用快速指令、斜線指令或訊息動作。

   4. 選用：新增其他互動式功能，例如啟動提示詞、指令 (快速指令、斜線指令和訊息建議動作) 或連結預覽。

   5. 在「可見度」下方指定電子郵件地址，即可在發布至 Google Workspace Marketplace 前安裝及測試 Chat 應用程式。最多可指定五位使用者，或一或多個 Google Workspace 機構的 Google 群組。

4. 選用：在「記錄」下方，選取「將錯誤記錄到 Logging」核取方塊，即可使用 Google Cloud Logging。詳情請參閱「查詢 Chat 擴充應用程式的錯誤記錄」。

5. 按一下 [儲存]。

儲存設定後，凡是在 Chat API 的「可見度」設定中指定的使用者，都能安裝、測試或使用 Chat 應用程式。如要開始測試及偵錯 Chat 應用程式，請參閱「測試 Google Chat 應用程式的互動功能」。

現有 Google Workspace 外掛程式的注意事項

Chat 擴充應用程式與擴充其他 Google Workspace 應用程式的 Google Workspace 外掛程式相比，需要不同的設定。如果外掛程式會擴充其他 Google Workspace 應用程式，請考慮下列設定 Chat 應用程式的要求：

• 個人和 Google Workspace 管理員都必須能夠從 Marketplace 安裝外掛程式。您可以在 Google Workspace Marketplace SDK 中設定這些安裝設定。
• Chat 應用程式不會使用您在資訊清單的 addons.common 物件中，為其他 Google Workspace 應用程式設定的名稱和標誌。
• 如果外掛程式已發布到 Google Workspace Marketplace，您就無法儲存 Google Chat API 設定的任何變更草稿。更新並儲存 Chat API 設定後，所有現有使用者都能立即使用更新後的 Chat 應用程式。如要更新市集資訊，請先建立草稿，再提交變更。
• 如果您是使用 Apps Script 建立外掛程式：
  • 您必須使用與其餘外掛程式設定相同的 Apps Script 部署作業 ID。
  • 您無法使用 Apps Script 指令碼編輯器在 Chat 中安裝測試部署。而是必須直接從 Chat 使用者介面安裝。
• 如果您使用 HTTP 服務建構外掛程式，請在透過 Google Workspace 外掛程式 API 建立的資訊清單和部署作業中，省略任何 Chat 應用程式設定詳細資料。您在 Google Workspace Marketplace SDK 中指定的 HTTP 部署作業，僅適用於其他 Google Workspace 應用程式。

授予他人設定 Chat API 的權限

您可以授予 Chat 應用程式擁有者或 Chat 應用程式檢視者 Google Cloud Identity Access Management (IAM) 角色，將 Chat 應用程式設定頁面的存取權授予特定使用者。具備這類角色的使用者無法透過「API 和服務」資訊主頁前往 Chat 應用程式設定頁面，但可以按照下列步驟，前往 Chat 應用程式主機雲端專案的 Google Cloud 控制台，存取設定頁面：

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

其中 PROJECT_ID 是代管 Chat 應用程式的 Google Cloud 專案 ID。

具備專案角色的使用者也可以存取應用程式設定頁面。

如果使用者擁有包含 resourcemanager.projects.(get|update) 權限的自訂角色，就無法存取 Chat 應用程式設定。如果是自訂角色，請改用 chat.bots.(get|update) 權限。

相關主題

• 選擇 Chat 擴充應用程式架構
• 接收及回應使用者互動
• 測試 Google Chat 應用程式的互動功能

非外掛程式的 Chat 應用程式：設定 Google Chat API

如果您維護的 Chat 擴充應用程式不是 Google Workspace 外掛程式，設定會使用單一端點處理所有互動事件，而不是每個事件的觸發條件：

1. 在 Google Cloud 控制台中，前往 Chat API 的「Configuration」(設定) 頁面：

   前往 Chat API 設定頁面

2. 在「互動功能」下方，開啟「啟用互動功能」。

3. 取消勾選「將這個 Chat 擴充應用程式建構為 Google Workspace 外掛程式」。系統會開啟對話方塊，要求您確認。在對話方塊中，按一下「停用」。

4. 在「功能」下方，視需要選取「支援應用程式首頁」或「加入聊天室和群組對話」。

5. 在「連線設定」下方，為 Chat 應用程式指定單一端點 (HTTP 端點網址、Apps Script 部署 ID、Cloud Pub/Sub 主題名稱或 Dialogflow)。

6. 設定選用的「指令」、「連結預覽」、「瀏覽權限」和「記錄」，然後按一下「儲存」。

如要將非外掛程式的 Chat 擴充應用程式升級為可擴充 Google Chat 的 Google Workspace 外掛程式，請參閱「將 Google Chat 擴充應用程式轉換為 Google Workspace 外掛程式」。