Autoriza a apps de Google Chat para que importen datos
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Con la API de Google Chat, las apps pueden importar datos de otras plataformas de mensajería a Google Chat usando espacios en modo de importación. Para obtener más información, consulta Cómo importar datos de mensajes a Google Chat desde otro servicio.
Para leer y escribir recursos en espacios en modo de importación, debes autenticar las apps de Chat con una cuenta de servicio.
Un administrador debe otorgar a la cuenta de servicio el siguiente alcance de autorización de la API de Chat: https://www.googleapis.com/auth/chat.import.
Solo los administradores de dominio de Google Workspace pueden otorgar este permiso de OAuth a las cuentas de servicio a través de la delegación de todo el dominio.
Todos los dominios en los que una app de Chat crea espacios en modo de importación deben tener este permiso de OAuth. Después de que se delega la autoridad en todo el dominio a la cuenta de servicio para este alcance, las apps de Chat pueden acceder a los espacios en modo de importación suplantando la identidad de una cuenta de usuario.
En algunos casos, es posible que la cuenta de usuario para la suplantación ya no esté disponible. En estos casos, la app de Chat puede usar las credenciales de su cuenta de servicio como alternativa. Por ejemplo, si borras una cuenta de usuario que se usó durante la creación de un mensaje, la app de Chat puede usar sus propias credenciales de cuenta de servicio para crear un mensaje con el mismo contenido. Las apps de chat pueden acceder a los espacios en modo de importación como una app que usa credenciales de cuenta de servicio con el siguiente alcance de OAuth: https://www.googleapis.com/auth/chat.bot.
No se requieren otros permisos de la API de Google Chat cuando se importan recursos a un espacio en modo de importación.
Las apps de Chat solo pueden importar contenido a los espacios en modo de importación que crean, no a los espacios en modo de importación creados por otras apps.
En la siguiente tabla, se enumeran los métodos de recursos que las apps de Chat pueden llamar en espacios en modo de importación y el tipo de autenticación que admiten:
Método del recurso |
Se admite la identidad temporal de usuarios |
Se admiten credenciales de cuentas de servicio |
spaces.create
|
Sí |
No |
spaces.get
|
No |
Sí |
spaces.update
|
Sí |
No |
spaces.delete
|
Sí |
No |
spaces.completeImport
|
Sí |
No |
spaces.messages.create
|
Sí |
Sí |
spaces.messages.delete
|
Sí |
Sí |
spaces.messages.get
|
No |
Sí |
spaces.messages.list
|
Sí |
No |
spaces.messages.update
|
Sí |
Sí |
spaces.messages.reactions.create
|
Sí |
No |
spaces.messages.reactions.delete
|
Sí |
No |
spaces.members.create
|
Sí |
No |
spaces.members.delete
|
Sí |
No |
spaces.members.list
|
Sí |
No |
media.upload
|
Sí |
No |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 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)."]]
