本頁面說明如何將 Google Chat 應用程式連結至 Google Chat 以外的服務或工具。即時通訊應用程式可單獨提供強大功能,但通常能與其他系統搭配運作,並要求隨附應用程式才能連結帳戶、授權資料存取權、顯示額外資料,或調整使用者的偏好設定。
要求使用者授予 Chat 應用程式設定
如果要求所需的額外設定無法在 Chat 應用程式中直接完成,請在一般回覆中傳回設定網址,或是以私密方式呈現,請使用下方表單:
{ "actionResponse": { "type": "REQUEST_CONFIG", "url": "CONFIGURATION_URL" } }
這樣一來,Google Chat 就會向使用者顯示私人提示,其中 CONFIGURATION_URL
是可讓使用者前往的其他驗證、授權或設定連結。REQUEST_CONFIG
回應與一般回應訊息互斥,系統會忽略所有文字、資訊卡或其他屬性。
完成設定要求
Chat 應用程式收到的每個 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 登入回應中的識別憑證來識別使用者。