發布 Google Chat 應用程式

建立即時通訊應用程式後,您可以發布該應用程式,供特定使用者或群組、您的 Google Workspace 機構中的所有人,或任何 Google Chat 使用者使用。

使用者如何探索及使用 Google Chat 應用程式

如要探索 Google Chat 應用程式,使用者可以執行下列任一操作:

  • 搜尋及安裝 Google Chat 中的應用程式。
  • 與已加入 Chat 聊天室的應用程式互動。
  • Google Workspace 管理員代表他們安裝應用程式後,透過即時訊息面板探索應用程式。

如要開始使用應用程式,Google Chat 使用者可以向應用程式發起即時訊息,或是將訊息新增至聊天室。使用者也可以使用 @ 號提及他人,直接新增應用程式。以下範例顯示使用者如何使用 @ 提及 Chat 應用程式,並將應用程式新增至聊天室:

如要在聊天室中新增應用程式,請在訊息中輸入「@」。

或者,Google Workspace 管理員可以在 Google Workspace Marketplace 中尋找 Chat 應用程式,並為機構中的使用者安裝應用程式。當管理員安裝 Chat 專用應用程式時,應用程式會顯示在使用者的即時訊息面板中。

Google Workspace 管理員也能管理及允許在 Google Workspace 機構中使用 Chat 應用程式的功能。如果您要為使用許可清單的機構開發 Chat 應用程式,您必須要求管理員將您的 Chat 應用程式加入許可清單,這樣使用者才能找到並使用該應用程式。詳情請參閱 Google Workspace 管理員說明中心的「允許使用者安裝 Chat 應用程式」。

使用 Google Cloud 控制台設定並發布 Chat 應用程式

一般來說,如要發布即時通訊應用程式並供他人使用,您必須按照以下步驟操作:

  1. 啟用及設定 Google Chat API。設定 API 時,您會授權其他 Google Chat 使用者存取您的 Chat 應用程式以進行測試。
  2. 使用 Google Workspace Marketplace SDK 發布應用程式。您可以設定 Chat 應用程式,開放 Google Workspace 機構中的使用者或所有 Google Chat 使用者使用。
  3. 如果您的 Google Workspace 機構會管理 Chat 應用程式的存取權,請要求 Google Workspace 管理員將應用程式加入機構的許可清單。

Chat 應用程式的瀏覽權限和發布設定

下表說明如何依據 Chat 應用程式的目標對象,調整 Google Chat API 和 Google Workspace Marketplace SDK 的設定:

目標應用程式使用者 驗證方式 Google Chat API 設定 Google Workspace Marketplace SDK 設定 我的 Chat 應用程式會在哪裡發布?
小型團隊 使用者應用程式的身分進行驗證。 在「Visibility」(顯示設定) 設定中,指定有權存取應用程式的使用者或 Google 群組。

如果 Google Workspace 帳戶要求將應用程式加入許可清單,您最多只能指定 5 個個別電子郵件地址 (您無法指定 Google 網路論壇)。

您不需要為 Chat 應用程式設定 Google Workspace Marketplace SDK。 團隊成員可以在 Google Chat 中找到並使用您的 Chat 應用程式。
大型團隊 使用者應用程式的身分進行驗證。 在「瀏覽權限」設定中指定要測試 Chat 應用程式的使用者或 Google 群組。

測試完成後,請使用 Google Workspace Marketplace SDK 中的設定,將 Chat 專用應用程式發布到 Google Workspace 機構。

將「應用程式顯示設定」設為「私人」

將「安裝設定」設為「個人 + 管理員」

如果您的 Google Workspace 帳戶規定應用程式必須加入許可清單,請要求管理員將您的 Chat 應用程式加入許可清單,這樣使用者就能找到並使用該應用程式。詳情請參閱 Google Workspace 管理員說明的說明文件:允許使用者安裝 Chat 應用程式

讓 Google Workspace 機構中的所有使用者都能在 Google Chat 中找到並安裝您的 Chat 專用應用程式,也能在 Google Workspace Marketplace 中查看您的應用程式。使用者和 Google Workspace 管理員可以從 Marketplace 安裝應用程式。

您的 Google Workspace 機構 使用者應用程式的身分進行驗證。 在「瀏覽權限」設定中,指定要測試 Chat 應用程式的使用者或 Google 群組。

測試完成後,請使用 Google Workspace Marketplace SDK 中的設定,將 Chat 專用應用程式發布到 Google Workspace 機構。

將「應用程式顯示設定」設為「私人」

將「安裝設定」設為「個人 + 管理員」

讓 Google Workspace 機構中的所有使用者都能在 Google Chat 中找到並安裝您的 Chat 專用應用程式,也能在 Google Workspace Marketplace 中查看您的應用程式。只有 Google Workspace 管理員可以從 Marketplace 安裝應用程式。

所有人 (公開 Chat 應用程式) 使用者應用程式的身分進行驗證。 在「瀏覽權限」設定中,指定要測試 Chat 應用程式的使用者或 Google 群組。

測試完畢後,請使用 Google Workspace Marketplace 中的設定公開發布 Chat 專用應用程式。

將「應用程式顯示設定」設為「公開」

將「安裝設定」設為「個人 + 管理員」

所有 Google Workspace 使用者都能在 Google Chat 中找到並安裝您的 Chat 專用應用程式,也能在 Google Workspace Marketplace 中查看您的應用程式。只有 Google Workspace 管理員可以從 Marketplace 安裝應用程式。

啟用及設定 Google Chat API

Google Cloud 控制台中設定應用程式專案,並啟用 Google Chat API:

  1. 請使用下方按鈕建立新專案 (或選取現有專案) 並新增服務帳戶。將專案擁有者角色指派給服務帳戶。
    啟用 API
  2. 儲存下載的 JSON 金鑰。您的應用程式可以使用這組金鑰,以非同步方式驗證傳送至聊天室的訊息。
  3. 中開啟專案。 在 API 清單中,按一下「Google Chat API」
  4. 選取「Configuration」分頁標籤,然後輸入應用程式的資訊,如下表所示。

儲存應用程式設定後,您的應用程式就能供 Google Workspace 機構中的指定使用者使用。

Google Chat API 配置設定

欄位 說明
應用程式名稱 使用者與 Chat 應用程式互動時使用的名稱。
顯示圖片網址 指向正方形圖形圖片 (例如 PNG 或 JPEG) 的 HTTPS 網址,網址至少為 128x128,並顯示為 Chat 應用程式的顯示圖片。
說明 即時通訊應用程式功能說明 (顯示在 Chat 應用程式名稱下方)。
功能 用來決定 Chat 應用程式與使用者互動方式的一組欄位:
  • 接收 1:1 訊息:使用者可以直接在 Google Chat 中找到 Chat 應用程式並傳送訊息給該應用程式。
  • 加入聊天室和群組對話:使用者可以將 Chat 應用程式加入聊天室和群組對話。
連線設定 Chat 應用程式的端點如下:
  • 應用程式網址:代管 Chat 應用程式實作的 HTTPS 端點。
  • Apps Script 專案:實作 Chat 應用程式的 Apps Script 專案部署作業 ID。
  • Cloud Pub/Sub 主題名稱:Chat 應用程式以端點的形式訂閱的 Cloud Pub/Sub 主題。
  • Dialogflow:註冊與 Dialogflow 整合的 Chat 應用程式。詳情請參閱 Dialogflow 說明文件,瞭解如何與 Google Chat 整合。
斜線指令 可在 Google Chat 中向使用者顯示的指令。允許使用者在 Google Chat 中查看 Chat 應用程式的核心動作,並選擇要互動的特定動作。
連結預覽 Chat 應用程式可辨識的網址模式,並在使用者傳送連結時提供額外內容。詳情請參閱「預覽連結」一文。
瀏覽權限 最多可供 5 名個人或一或多個 Google 群組查看及安裝 Chat 應用程式。您可以使用這個欄位測試 Chat 應用程式,或是與團隊成員分享 Chat 應用程式。詳情請參閱Chat 應用程式的瀏覽權限和發布設定

授予應用程式設定權限

您可以授權特定使用者存取應用程式設定頁面,如要執行此操作,請使用即時通訊應用程式擁有者即時通訊應用程式檢視者 IAM 角色。具備這些角色的使用者無法透過「API 和服務」資訊主頁前往應用程式設定頁面,但可以透過下列方式前往專案的控制台存取設定頁面:

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

使用 Google Workspace Marketplace SDK 發布應用程式

Google Workspace Marketplace SDK 的用途如下:

  • 公開發布應用程式,讓任何 Google Chat 使用者將您的 Chat 應用程式新增至聊天室。
  • 將應用程式發布到您的網域。
  • 開放 Google Workspace 管理員查看您的應用程式,以便為機構中的使用者安裝應用程式。應用程式必須具有直接訊息功能,Google Workspace 管理員才能查看。

使用 Google Workspace Marketplace SDK 發布應用程式前,請按照下列步驟操作:

  1. 從 Chat 安裝 Chat 應用程式,以便測試。請確認您的應用程式可以正常運作,且不會正常運作。
  2. 請詳閱發布規定,確認應用程式是否符合所有項目。請參閱「審查領域」。
  3. 記錄應用程式的版本號碼,以設定 Google Workspace Marketplace SDK。

當您準備好要發布時,請參閱總覽:發布應用程式

停用 Chat 應用程式

儲存設定頁面後,系統會顯示「App Status」欄位。這個欄位可讓您控制應用程式為「Live」或「Disabled」

如何停用 Chat 應用程式:

  1. 開啟 Google Cloud 控制台
  2. 視需要選取代管 Chat 應用程式的 Google Cloud 專案:
    1. 按一下「Google Cloud」旁邊的向下箭頭 。畫面隨即顯示一個對話方塊,列出目前的專案。
    2. 選取託管已遷移 Chat 應用程式的專案。
    3. 按一下「開啟」
  3. 搜尋「Google Chat API」,然後按一下「Google Chat API」
  4. 按一下 [Manage] (管理)
  5. 按一下「Configuration」
  6. 在「應用程式狀態」部分,選取「已停用」
  7. 按一下「儲存」。