本頁面說明如何連結 Google Chat 應用程式與 Google Chat 以外的服務或工具。雖然 Chat 本身本身就十分強大,但往往會與其他系統搭配使用,並需要搭配的應用程式來連結帳戶、授權資料存取權、顯示其他資料,或調整使用者偏好設定。
要求使用者設定即時通訊應用程式設定
如果完成要求需要的額外設定無法直接在 Chat 應用程式中完成,請將設定網址透過一般回覆的形式傳回給使用者,或是以不公開的方式顯示,格式如下:
{ "actionResponse": { "type": "REQUEST_CONFIG", "url": "CONFIGURATION_URL" } }
這會指示 Google Chat 向使用者顯示私人提示,其中 CONFIGURATION_URL
是一個連結,可供使用者前往進行其他驗證、授權或設定。REQUEST_CONFIG
回應與一般回應訊息彼此互斥。系統會忽略所有文字、資訊卡或其他屬性。
完成設定要求
即時通訊應用程式收到的每個 MESSAGE
互動事件也都會包含 configCompleteRedirectUrl
參數。這個網址應在設定網址中進行編碼,以便完成程序。重新導向至這個網址會向 Google Chat 表明設定要求已完成。
Chat 應用程式啟動時,流程會視收到的特定訊息而定。為了回應 @app help
這類訊息,Chat 應用程式應以訊息回覆,且不必進行額外設定。
當使用者成功重新導向至原始訊息中提供的 configCompleteRedirectUrl
時,Google Chat 會執行下列步驟:
- 清除啟動中使用者看到的提示。
- 將原始訊息轉換為公開訊息,讓聊天室的其他成員都能看到。
- 再次將原始訊息傳送至同一個 Chat 應用程式。
造訪 configCompleteRedirectUrl
只會影響單一使用者訊息。如果使用者多次嘗試傳送訊息給 Chat 應用程式,因而收到多個提示,請點選特定提示並完成驗證和設定程序,只會影響該特定訊息。其他訊息則不會變更。
如果以這種方式重新傳送 MESSAGE
互動事件,則該事件應與原始事件相同,但在某些情況下,MESSAGE
互動事件可能會有所不同。舉例來說,如果訊息同時提及 Chat 應用程式 A 和 Chat 應用程式 B,如果 Chat 應用程式 A 在向 Chat 應用程式 B 進行驗證前傳送一般訊息回應,則使用者可以編輯訊息。在這種情況下,Chat 應用程式 B 會在使用者完成驗證和設定後收到編輯後的訊息文字。
在 Chat 外驗證 Chat 使用者
在某些情況下 (例如要求 API 的 OAuth 授權),您的應用程式需要連結至 Chat 以外的網址,同時保留使用者身分。在這些情況下識別使用者的最佳方式,是使用 Google 登入保護目標應用程式。
使用登入期間核發的身分識別權杖取得使用者 ID。sub
憑證附加資訊包含使用者的專屬 ID,可與 Google Chat 中的使用者 ID 建立關聯。
雖然這兩個 ID 不完全相同,但可能會強制轉換。如要將 sub
要求值強制強制轉換為 Google Chat users/{user}
,請在該值前面加上 users/
。舉例來說,123
聲明值等同於 Chat 應用程式訊息中的使用者名稱 users/123
。
相關主題
- MyProfile 應用程式範例使用 Google 登入回應中的識別憑證來識別使用者。