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, il se peut que le compte utilisateur pour l'usurpation d'identité ne soit plus 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 lorsque vous importez des 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 |
|---|---|---|
|
Oui |
Non |
|
Non |
Oui |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Oui |
|
Oui |
Oui |
|
Non |
Oui |
|
Oui |
Non |
|
Oui |
Oui |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Non |
|
Oui |
Non |
Articles associés
- Pour en savoir plus sur l'authentification et l'autorisation, consultez Authentifier et autoriser les applications Google Chat et les requêtes API.
- Pour savoir comment configurer un compte de service pour accéder à l'API Google Chat, consultez S'authentifier en tant qu'application Google Chat.
- Pour savoir comment commencer à importer des ressources à l'aide d'espaces en mode importation, consultez Importer des données dans Google Chat.