Autorizar apps do Google Chat a importar dados
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a API Google Chat, os apps podem importar dados de outras plataformas de mensagens para o Google Chat usando espaços no modo de importação. Para mais informações, consulte
Importar dados de mensagens de outro serviço para o Google Chat.
Para ler e gravar recursos em espaços no modo de importação, é necessário
autenticar os apps do Chat com uma conta de serviço.
Conceda à conta de serviço o seguinte escopo de autorização da API Chat
por um administrador: https://www.googleapis.com/auth/chat.import.
Somente os administradores do domínio do Google Workspace podem conceder esse escopo do OAuth a
contas de serviço usando a
delegação em todo o domínio.
Todos os domínios em que um app do Chat cria espaços no modo de importação
precisam ter esse escopo OAuth. Depois que a conta de serviço receber a delegação de autoridade em todo o domínio para esse escopo, os apps do Chat poderão acessar os espaços no modo de importação representando uma conta de usuário.
Em alguns casos, a conta de usuário para representação pode não estar mais
disponível. Nesses casos, o app Chat pode usar as credenciais da conta de serviço como alternativa. Por exemplo, se você excluir uma conta de usuário usada durante a criação de uma mensagem, o app Chat poderá usar as credenciais da própria conta de serviço para criar uma mensagem com o mesmo conteúdo. Os apps do Chat podem
acessar espaços no modo de importação como um app usando credenciais de conta de serviço com o
seguinte escopo do OAuth: https://www.googleapis.com/auth/chat.bot.
Nenhum outro escopo da API Google Chat
é necessário ao importar recursos para um espaço no modo de importação.
Os apps do Chat só podem importar conteúdo para os espaços do modo de importação
que eles criam, e não para os espaços do modo de importação criados por outros apps.
A tabela a seguir lista os métodos de recursos que os apps do Chat podem
chamar em espaços do modo de importação e o tipo de autenticação compatível:
Método do recurso |
Representação de usuário compatível |
Credenciais de conta de serviço aceitas |
spaces.create
|
Sim |
Não |
spaces.get
|
Não |
Sim |
spaces.update
|
Sim |
Não |
spaces.delete
|
Sim |
Não |
spaces.completeImport
|
Sim |
Não |
spaces.messages.create
|
Sim |
Sim |
spaces.messages.delete
|
Sim |
Sim |
spaces.messages.get
|
Não |
Sim |
spaces.messages.list
|
Sim |
Não |
spaces.messages.update
|
Sim |
Sim |
spaces.messages.reactions.create
|
Sim |
Não |
spaces.messages.reactions.delete
|
Sim |
Não |
spaces.members.create
|
Sim |
Não |
spaces.members.delete
|
Sim |
Não |
spaces.members.list
|
Sim |
Não |
media.upload
|
Sim |
Não |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eGoogle Chat API allows importing data from other platforms into Google Chat using import mode spaces.\u003c/p\u003e\n"],["\u003cp\u003eChat apps require specific authentication and authorization to read and write resources in these spaces, needing domain administrator approval.\u003c/p\u003e\n"],["\u003cp\u003eApps can impersonate user accounts or utilize their service account credentials for specific actions within import mode spaces.\u003c/p\u003e\n"],["\u003cp\u003eImport mode spaces support various resource methods with differing authentication requirements, as detailed in the provided table.\u003c/p\u003e\n"],["\u003cp\u003eChat apps can only import content into spaces they create and not into spaces created by other apps.\u003c/p\u003e\n"]]],["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"],null,["# Authorize Google Chat apps to import data\n\nWith the Google Chat API, apps can import data from other messaging platforms into\nGoogle Chat by using *import mode* spaces. For more information, see\n[Import message data to Google Chat from another service](https://support.google.com/a/answer/13465849).\n\nTo read and write resources in import mode spaces, you must\n[authenticate Chat apps with a service account](/workspace/chat/authenticate-authorize-chat-app).\nGrant the service account the following Chat API authorization scope\nby an administrator: `https://www.googleapis.com/auth/chat.import`.\n\nOnly Google Workspace domain administrators can grant this OAuth scope to\nservice accounts through\n[domain-wide delegation](/identity/protocols/oauth2/service-account#delegatingauthority).\nEvery domain that a Chat app creates import mode spaces\nin must have this OAuth scope. After the service account has been delegated\ndomain-wide authority for this scope, Chat apps can access import\nmode spaces by\n[impersonating a user account](/identity/protocols/oauth2/service-account#authorizingrequests).\n\nIn some scenarios, the user account for impersonation might no longer be\navailable. In these cases, the Chat app can use their\nservice account credentials as a fallback. For example, if you delete a user\naccount that was used during message creation, the\nChat app can use their own service account credentials\nto create a message containing the same contents. Chat apps can\naccess import mode spaces as an app using service account credentials with the\nfollowing OAuth scope: `https://www.googleapis.com/auth/chat.bot`.\n\nNo other [Google Chat API scopes](/workspace/chat/authenticate-authorize#scopes)\nare required when importing resources into an import mode space.\nChat apps can only import content into the import mode spaces\nthat they create, and not into the import mode spaces created by other apps.\n\nThe following table lists the resource methods that Chat apps can\ncall in import mode spaces, and what kind of authentication they support:\n\n| Resource method | User impersonation supported | Service account credentials supported |\n|------------------------------------|------------------------------|---------------------------------------|\n| `spaces.create` | Yes | No |\n| `spaces.get` | No | Yes |\n| `spaces.update` | Yes | No |\n| `spaces.delete` | Yes | No |\n| `spaces.completeImport` | Yes | No |\n| `spaces.messages.create` | Yes | Yes |\n| `spaces.messages.delete` | Yes | Yes |\n| `spaces.messages.get` | No | Yes |\n| `spaces.messages.list` | Yes | No |\n| `spaces.messages.update` | Yes | Yes |\n| `spaces.messages.reactions.create` | Yes | No |\n| `spaces.messages.reactions.delete` | Yes | No |\n| `spaces.members.create` | Yes | No |\n| `spaces.members.delete` | Yes | No |\n| `spaces.members.list` | Yes | No |\n| `media.upload` | Yes | No |\n\nRelated topics\n--------------\n\n- To learn more about authentication and authorization, see [Authenticate and authorize Google Chat apps and API requests](/workspace/chat/authenticate-authorize).\n- To learn how to set up a service account to access the Google Chat API, see [Authenticate as a Google Chat app](/workspace/chat/authenticate-authorize-chat-app).\n- To learn how to start importing resources using import mode spaces, see [Import data to Google Chat](/workspace/chat/import-data)."]]
