設定 Google Chat API

您建立的每個 Google Chat 應用程式都需要自己的 Google Cloud 專案，並啟用 Chat API。本頁面說明如何設定 Chat API。

必要條件

設定 Chat API

  1. 在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」和「管理」。

    前往 Chat API

  2. 按一下「Configuration」分頁標籤，然後輸入下列必要資訊：

    • 應用程式名稱：使用者與您的 Chat 應用程式互動時使用的名稱。
    • 顯示圖片網址：指向 Chat 應用程式顯示圖片的 HTTPS 網址 (例如 PNG 或 JPEG)，至少 128x128。
    • 說明：Chat 應用程式預期用途的說明，會顯示在 Chat 應用程式名稱下方。

  3. 如要開啟互動功能，請按一下「啟用互動式功能」切換鈕，讓使用者與您的 Chat 應用程式互動，並使用下表完成設定：

    欄位 說明
    功能 這組欄位會決定 Chat 應用程式如何與使用者互動：
    • 接收 1:1 訊息：使用者可以直接在 Google Chat 中找到 Chat 應用程式並傳送訊息給對方。
    • 加入聊天室和群組對話：使用者可將 Chat 應用程式新增至聊天室和群組對話。
    連線設定 Chat 應用程式的端點，會是下列其中一種：
    • 應用程式網址：代管 Chat 應用程式實作項目的 HTTPS 端點。
    • Apps Script 專案：實作 Chat 應用程式的 Apps Script 專案部署作業 ID。
    • Cloud Pub/Sub 主題名稱：Chat 應用程式以端點形式訂閱的 Pub/Sub 主題。
    • Dialogflow：透過 Dialogflow 整合註冊 Chat 應用程式。詳情請參閱「建構能理解自然語言的 Dialogflow Google Chat 應用程式」。
    斜線指令 可在 Google Chat 中向使用者顯示的指令。允許使用者在 Google Chat 中查看 Chat 應用程式的核心動作，並選擇要互動的特定動作。詳情請參閱「以 Chat 應用程式的形式回應斜線指令」。
    連結預覽 Chat 應用程式可辨識的網址模式，並在使用者傳送連結時提供額外內容。詳情請參閱「預覽連結」。
    能見度 最多 5 人或一或多個 Google 群組，可以查看及安裝 Chat 應用程式。請使用這個欄位測試 Chat 應用程式，或是將 Chat 應用程式分享給團隊成員。詳情請參閱「Chat 應用程式的顯示和發布設定」。

  4. 如要在 Chat 應用程式傳回錯誤時將錯誤記錄到 Cloud Logging，請勾選「Log errors to Logging」(將錯誤記錄至 Logging) 核取方塊。詳情請參閱「查詢即時通訊應用程式的錯誤記錄」。

  5. 按一下「儲存」。當您儲存 Chat 應用程式設定後，Google Workspace 機構中的指定使用者就能使用您的 Chat 應用程式。

授予其他使用者設定 Chat 應用程式的權限

您可以將存取權授予特定使用者 Chat 應用程式設定頁面。請使用「Chat 應用程式擁有者」和「Chat 應用程式檢視者」 IAM 角色。具備這些角色的使用者無法透過「API 和服務」資訊主頁前往 Chat 應用程式設定頁面，但可以前往 Chat 應用程式託管 Cloud 專案的 Google Cloud 控制台存取設定頁面，如下所示：

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

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