授權 Google Chat 應用程式匯入資料
只要使用 Google Chat API,應用程式就能透過「匯入模式」聊天室,將資料從其他訊息平台匯入 Google Chat。詳情請參閱「將訊息資料從其他服務匯入 Google Chat」。
如要在匯入模式空間中讀取及寫入資源,您必須使用服務帳戶驗證 Chat 應用程式。由管理員授予服務帳戶下列 Chat API 授權範圍:https://www.googleapis.com/auth/chat.import
。
只有 Google Workspace 網域管理員可以透過全網域委派,將這個 OAuth 範圍授予服務帳戶。Chat 應用程式在其中建立匯入模式聊天室的每個網域都必須具備這個 OAuth 範圍。服務帳戶已委派全網域授權給這個範圍後,Chat 應用程式就可以冒用使用者帳戶,存取匯入模式聊天室。
在某些情況下,冒用身分的使用者帳戶可能會無法使用。在這種情況下,Chat 應用程式可以使用服務帳戶憑證做為備用方案。舉例來說,如果您刪除在建立訊息時使用的使用者帳戶,Chat 應用程式可以使用該帳戶的服務帳戶憑證,建立含有相同內容的訊息。Chat 應用程式可以使用服務帳戶憑證,以應用程式身分存取匯入模式空間,且 OAuth 範圍為 https://www.googleapis.com/auth/chat.bot
。
將資源匯入匯入模式空間時,不需要其他 Google Chat API 範圍。Chat 應用程式只能將內容匯入自己建立的匯入模式聊天室,而無法匯入其他應用程式建立的匯入模式聊天室。
下表列出 Chat 應用程式可在匯入模式空間中呼叫的資源方法,以及這些方法支援的驗證類型:
資源方法 |
支援使用者身分模擬 |
支援服務帳戶憑證 |
spaces.create
|
是 |
否 |
spaces.get
|
否 |
是 |
spaces.update
|
是 |
否 |
spaces.delete
|
是 |
否 |
spaces.completeImport
|
是 |
否 |
spaces.messages.create
|
是 |
是 |
spaces.messages.delete
|
是 |
是 |
spaces.messages.get
|
否 |
是 |
spaces.messages.list
|
是 |
否 |
spaces.messages.update
|
是 |
是 |
spaces.messages.reactions.create
|
是 |
否 |
spaces.messages.reactions.delete
|
是 |
否 |
spaces.members.create
|
是 |
否 |
spaces.members.delete
|
是 |
否 |
spaces.members.list
|
是 |
否 |
media.upload
|
是 |
否 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-21 (世界標準時間)。
[null,null,["上次更新時間:2024-12-21 (世界標準時間)。"],[[["Google Chat API allows importing data from other platforms into Google Chat using import mode spaces."],["Chat apps require specific authentication and authorization to read and write resources in these spaces, needing domain administrator approval."],["Apps can impersonate user accounts or utilize their service account credentials for specific actions within import mode spaces."],["Import mode spaces support various resource methods with differing authentication requirements, as detailed in the provided table."],["Chat apps can only import content into spaces they create and not into spaces created by other apps."]]],["Apps use the Google Chat API's import mode to bring data from other platforms into Google Chat. This requires authentication with a service account granted the `https://www.googleapis.com/auth/chat.import` scope via domain-wide delegation by a Google Workspace admin. Apps can impersonate user accounts or use service account credentials (`https://www.googleapis.com/auth/chat.bot`). Only specific resource methods are supported in import mode spaces. Import mode is exclusive, meaning apps can only modify spaces they create.\n"]]