With the Google Chat API, apps can import data from other messaging platforms into Google Chat by using import mode spaces. For more information, see Import message data to Google Chat from another service.
To read and write resources in import mode spaces, you must
authenticate Chat apps with a service account.
Grant the service account the following Chat API authorization scope
by an administrator: https://www.googleapis.com/auth/chat.import
.
Only Google Workspace domain administrators can grant this OAuth scope to service accounts through domain-wide delegation. Every domain that a Chat app creates import mode spaces in must have this OAuth scope. After the service account has been delegated domain-wide authority for this scope, Chat apps can access import mode spaces by impersonating a user account.
In some scenarios, the user account for impersonation might no longer be
available. In these cases, the Chat app can use their
service account credentials as a fallback. For example, if you delete a user
account that was used during message creation, the
Chat app can use their own service account credentials
to create a message containing the same contents. Chat apps can
access import mode spaces as an app using service account credentials with the
following OAuth scope: https://www.googleapis.com/auth/chat.bot
.
No other Google Chat API scopes are required when importing resources into an import mode space. Chat apps can only import content into the import mode spaces that they create, and not into the import mode spaces created by other apps.
The following table lists the resource methods that Chat apps can call in import mode spaces, and what kind of authentication they support:
Resource method |
User impersonation supported |
Service account credentials supported |
---|---|---|
|
Yes |
No |
|
No |
Yes |
|
Yes |
No |
|
Yes |
No |
|
Yes |
No |
|
Yes |
Yes |
|
Yes |
Yes |
|
No |
Yes |
|
Yes |
No |
|
Yes |
Yes |
|
Yes |
No |
|
Yes |
No |
|
Yes |
No |
|
Yes |
No |
|
Yes |
No |
|
Yes |
No |
Related topics
- To learn more about authentication and authorization, see Authenticate and authorize Google Chat apps and API requests.
- To learn how to start importing resources using import mode spaces, see Import data to Google Chat.