建立即時通訊應用程式後,您可以發布應用程式,供特定使用者或群組、貴機構中的任何人,或任何 Google Chat 使用者使用。
如要發布即時通訊應用程式並提供給其他人使用,您通常需按照下列步驟操作:
- 啟用及設定 Google Chat API。設定 API 時,您最多可以新增 5 個電子郵件地址來存取 Chat 應用程式,以便進行測試。
- 使用 Google Workspace Marketplace SDK 發布應用程式。您可以將 Chat 應用程式設為僅供 Google Workspace 機構中的使用者存取,或是提供給所有 Google Chat 使用者使用。
- 如果您的 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。
- 請使用下方按鈕建立新專案 (或選取現有專案),並在當中新增服務帳戶。將專案擁有者角色授予服務帳戶。
啟用 API - 儲存下載的 JSON 金鑰。您的應用程式可使用這組金鑰,驗證以非同步方式傳送至聊天室的訊息。
- 在 API Console 中開啟專案。在 API 清單中按一下 [Google Chat API]。
- 選取「Configuration」分頁標籤,然後輸入應用程式的資訊,如下所述。
儲存應用程式設定時,您的應用程式將提供給貴機構的指定使用者。
關於應用程式設定
欄位 | 說明 |
---|---|
應用程式名稱 | 使用者與您的應用程式互動時使用的名稱。 |
顯示圖片網址 | 指向正方形圖形圖片 (例如 PNG 或 JPEG 檔案) 的 HTTPS 網址,其顯示方式為應用程式的顯示圖片。 |
說明 | 顯示在應用程式名稱下方的應用程式功能說明。 |
功能 | 用來決定哪些事件可觸發應用程式的欄位集:
|
連線設定 | 應用程式的端點,如下所示:
|
斜線指令 | 可在 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 發布應用程式之前,請按照下列步驟操作:
- 如要測試 Chat 應用程式,請從 Chat 安裝。請確認您的應用程式可正常運作,且沒有進行中的作業。
- 詳閱發布規定,確認您的應用程式符合所有條件。請參閱評論區。
- 記錄應用程式的版本號碼 - 您需要這些資訊來設定 Google Workspace Marketplace SDK。
當您準備好要發布時,請參閱總覽:發布應用程式。
停用應用程式
儲存設定頁面後,畫面上會顯示「應用程式狀態」欄位。這個欄位可讓您控制應用程式是 Live 或 Disabled。
如何停用即時通訊應用程式:
- 開啟 Google Cloud 控制台。
- 視需要選取代管即時通訊應用程式的 Google Cloud 專案:
- 按一下「Google Cloud」旁邊的向下箭頭 。畫面上會出現列出目前專案的對話方塊。
- 選取代管已遷移即時通訊應用程式的專案。
- 按一下「Open」。
- 搜尋「Google Chat API」,然後按一下 [Google Chat API]。
- 按一下 [Manage] (管理)。
- 按一下 [Configuration]。
- 在「應用程式狀態」部分中,選取 [已停用]。
- 按一下「儲存」。