發布 Google Chat 應用程式

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

如要發布即時通訊應用程式並提供給其他人使用,您通常需按照下列步驟操作:

  1. 啟用及設定 Google Chat API。設定 API 時,您最多可以新增 5 個電子郵件地址來存取 Chat 應用程式,以便進行測試。
  2. 使用 Google Workspace Marketplace SDK 發布應用程式。您可以將 Chat 應用程式設為僅供 Google Workspace 機構中的使用者存取,或是提供給所有 Google Chat 使用者使用。
  3. 如果您的 Google Workspace 機構負責管理即時通訊應用程式的存取權,請要求 Google Workspace 管理員將應用程式加入機構的許可清單。

使用者如何使用或安裝即時通訊應用程式

發布 Chat 應用程式後,Google Chat 使用者可透過應用程式發起即時訊息,或是從建議的收件者清單中選擇應用程式 (如下所示),如下所示。

使用者也可以用 @號提及應用程式來縮小提議的收件者清單。舉例來說,如果您發布了名為「Scheduler Bot」的應用程式,且貴機構的使用者輸入了「@sch」,Google Chat 就會建議您的應用程式做為自動完成選項之一。

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

此外,Google Workspace 管理員也可以管理其 Google Workspace 機構中的即時通訊應用程式,並加入許可清單。如果您要為使用許可清單的機構開發 Chat 應用程式,必須要求管理員將您的即時通訊應用程式加入許可清單,這樣使用者才能找到及使用該應用程式。詳情請參閱 Google Workspace 管理員說明文章:允許使用者安裝即時通訊應用程式

啟用及設定 Google Chat API

Google API Console 中為應用程式設定專案,並啟用 Google Chat API。

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

儲存應用程式設定時,您的應用程式將提供給貴機構的指定使用者。

關於應用程式設定

欄位 說明
應用程式名稱 使用者與您的應用程式互動時使用的名稱。
顯示圖片網址 指向正方形圖形圖片 (例如 PNG 或 JPEG 檔案) 的 HTTPS 網址,其顯示方式為應用程式的顯示圖片。
說明 顯示在應用程式名稱下方的應用程式功能說明。
功能 用來決定哪些事件可觸發應用程式的欄位集:
  • 接收一對一訊息:使用者可以在 Google Chat 中找到應用程式並直接傳送訊息給應用程式。
  • 接收管理員安裝的事件:當 Google Workspace 管理員在機構中安裝或解除安裝應用程式時,會從 Chat 收到 ADDED_TO_SPACEREMOVED_FROM_SPACE 事件。根據預設,除非您選擇接收這類事件,否則應用程式不會接收這類事件,因為這可能會導致每秒查詢次數增加。
  • 加入聊天室和群組對話:應用程式可以在加入聊天室和群組對話後加入聊天室。
連線設定 應用程式的端點,如下所示:
  • 應用程式網址:代管應用程式導入作業的 HTTPS 端點。
  • Apps Script 專案:實作應用程式的 Apps Script 專案部署作業 ID。
  • Cloud Pub/Sub 主題名稱:應用程式以端點形式訂閱的 Cloud Pub/Sub 主題。
  • Dialogflow:使用 Dialogflow 整合來註冊應用程式。詳情請參閱 Dialogflow 說明文件,瞭解與 Google Chat 整合的相關資訊。
斜線指令 可在 Google Chat 中向使用者顯示的指令。允許使用者在 Google Chat 中查看您應用程式的核心動作,並且選擇想要互動的特定動作。
連結展開 應用程式可辨識的網址模式,且會在使用者傳送連結時提供額外內容。詳情請參閱深層連結連結
能見度 開發人員指定的應用程式瀏覽權限和安裝權限。您最多可以新增 5 個人或群組,以查看及安裝 Chat 應用程式。如要讓超過 5 位使用者能看到並安裝 Chat 應用程式,您必須使用 Google Workspace Marketplace SDK 發布應用程式

授予應用程式設定權限

您可以將應用程式設定頁面的存取權授予特定使用者。如要這麼做,請使用即時通訊應用程式擁有者Chat 應用程式檢視者身分與存取權管理角色。具備這些角色的使用者無法透過 API 和服務資訊主頁前往應用程式設定頁面,但可透過下列方法前往專案的主控台:

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

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

Google Workspace Marketplace SDK 的用途如下:

  • 公開發布您的應用程式,讓任何 Google Chat 使用者將 Chat 應用程式新增至聊天室。
  • 將應用程式發布到貴機構。
  • 讓 Google Workspace 管理員看見您的應用程式,以便他們為機構中的使用者安裝應用程式。Google Play 管理員必須使用應用程式提供直接訊息功能,才能看見這項資訊。

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

  1. 如要測試 Chat 應用程式,請從 Chat 安裝。請確認您的應用程式可正常運作,且沒有進行中的作業。
  2. 詳閱發布規定,確認您的應用程式符合所有條件。請參閱評論區
  3. 記錄應用程式的版本號碼 - 您需要這些資訊來設定 Google Workspace Marketplace SDK。

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

停用應用程式

儲存設定頁面後,畫面上會顯示「應用程式狀態」欄位。這個欄位可讓您控制應用程式是 LiveDisabled

如何停用即時通訊應用程式:

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