Autoriser les applications Google Chat à importer des données
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Google Chat permet aux applications d'importer des données depuis d'autres plates-formes de messagerie vers Google Chat à l'aide d'espaces en mode importation. Pour en savoir plus, consultez Importer les données des messages vers Google Chat à partir d'un autre service.
Pour lire et écrire des ressources dans des espaces en mode importation, vous devez authentifier les applications Chat avec un compte de service.
Accordez au compte de service le champ d'application d'autorisation de l'API Chat suivant par un administrateur : https://www.googleapis.com/auth/chat.import.
Seuls les administrateurs de domaine Google Workspace peuvent accorder ce champ d'application OAuth aux comptes de service via la délégation à l'échelle du domaine.
Chaque domaine dans lequel une application Chat crée des espaces en mode importation doit disposer de cette habilitation OAuth. Une fois que le compte de service a reçu une délégation d'autorité au niveau du domaine pour ce champ d'application, les applications Chat peuvent accéder aux espaces en mode importation en empruntant l'identité d'un compte utilisateur.
Dans certains cas, le compte utilisateur pour l'usurpation d'identité peut ne plus être disponible. Dans ce cas, l'application Chat peut utiliser les identifiants de leur compte de service comme solution de secours. Par exemple, si vous supprimez un compte utilisateur qui a été utilisé lors de la création d'un message, l'application Chat peut utiliser ses propres identifiants de compte de service pour créer un message contenant le même contenu. Les applications de chat peuvent accéder aux espaces en mode Importation en tant qu'application à l'aide d'identifiants de compte de service avec le champ d'application OAuth suivant : https://www.googleapis.com/auth/chat.bot.
Aucun autre champ d'application de l'API Google Chat n'est requis lors de l'importation de ressources dans un espace en mode importation.
Les applications Chat ne peuvent importer du contenu que dans les espaces en mode importation qu'elles créent, et non dans ceux créés par d'autres applications.
Le tableau suivant répertorie les méthodes de ressources que les applications Chat peuvent appeler dans les espaces en mode importation, ainsi que le type d'authentification qu'elles acceptent :
Méthode de ressource |
Emprunt d'identité utilisateur autorisé |
Identifiants de compte de service acceptés |
spaces.create
|
Oui |
Non |
spaces.get
|
Non |
Oui |
spaces.update
|
Oui |
Non |
spaces.delete
|
Oui |
Non |
spaces.completeImport
|
Oui |
Non |
spaces.messages.create
|
Oui |
Oui |
spaces.messages.delete
|
Oui |
Oui |
spaces.messages.get
|
Non |
Oui |
spaces.messages.list
|
Oui |
Non |
spaces.messages.update
|
Oui |
Oui |
spaces.messages.reactions.create
|
Oui |
Non |
spaces.messages.reactions.delete
|
Oui |
Non |
spaces.members.create
|
Oui |
Non |
spaces.members.delete
|
Oui |
Non |
spaces.members.list
|
Oui |
Non |
media.upload
|
Oui |
Non |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
