設定 Google Chat API

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

先備知識

設定 Chat API

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

    前往 Chat API

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

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

  3. 如要開啟互動功能，請按一下「EnableInteract features」切換鈕，讓使用者與您的 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」核取方塊。詳情請參閱「查詢 Chat 應用程式的錯誤記錄」。

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

授權他人設定 Chat 擴充應用程式

您可以授權特定使用者存取 Chat 應用程式設定頁面。請使用 Chat 應用程式擁有者和 Chat 應用程式檢視者 IAM 角色。具備這些角色的使用者無法透過「APIs & Services」(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。