Présentation du développement d'applications Google Chat pour importer des données utilisateur

Pour importer des données utilisateur d'autres plates-formes de messagerie dans Google Chat, vous pouvez créer une application Chat et un espace Chat en mode importation. Dans les espaces en mode importation, les applications Chat peuvent importer des messages, des pièces jointes, des réactions, des adhésions et des entités d'espace d'autres plates-formes existantes dans des ressources REST équivalentes. Vous ne pouvez utiliser les espaces en mode importation que pendant le processus d'importation.

Pourquoi utiliser les espaces en mode importation ?

Les espaces en mode importation offrent une meilleure expérience aux utilisateurs finaux qui passent d'autres plates-formes de messagerie à Google Chat. Par rapport à la copie des données sources dans des espaces standards, l'utilisation des espaces en mode importation présente les avantages suivants:

  • Préservation des codes temporels de création des ressources. Vous pouvez définir une heure historique pour les heures de création des espaces et des messages, ce qui permet aux applications Chat de conserver le contexte historique lorsque les utilisateurs adoptent Google Chat. Pour en savoir plus, consultez Importer des données dans Google Chat.
  • Les utilisateurs finaux ne peuvent pas afficher les espaces ni y accéder en mode importation. Pour éviter toute interférence de l'utilisateur dans un espace en cours d'importation de données ou pour éviter une confusion éventuelle des utilisateurs due à l'affichage d'une importation de données en cours, les espaces en mode importation sont masqués pour les utilisateurs finaux. Une fois qu'un espace a quitté le mode importation, vous pouvez lui ajouter des utilisateurs.
  • Chat désactive les notifications en mode importation afin que les utilisateurs ne reçoivent pas d'alertes inutiles sur la migration.

Ressources Google Chat compatibles avec les espaces en mode importation

Vous pouvez importer les ressources suivantes de l'API Google Chat à l'aide d'espaces en mode importation:

  • Messages
  • Pièces jointes, en tenant compte des points suivants :
    • Vous pouvez importer des pièces jointes dans des espaces en mode importation avec l'API Google Chat. Toutefois, nous vous recommandons vivement d'utiliser l'API Google Drive pour importer des fichiers et lier les URI des fichiers aux messages respectifs dans les espaces en mode importation afin d'éviter d'atteindre la limite interne de Google Chat pour l'importation de pièces jointes.
  • Réactions

  • Adhésions, en tenant compte des points suivants:

    • Les adhésions historiques doivent être importées lorsqu'un espace est en mode importation. Vous ne pouvez pas importer les adhésions historiques une fois que l'espace a terminé le mode importation.
    • Les autres appartenances existantes de la plate-forme de messagerie source doivent être créées une fois qu'un espace a quitté le mode importation.
    • Les membres doivent être des utilisateurs du même domaine.

  • Espaces : Seul SpaceType.SPACE est accepté.

Mapper les données sources avec les ressources Google Chat

Lorsque vous importez des données depuis des plates-formes de messagerie sources dans Google Chat, consultez les ressources compatibles que vous pouvez créer dans Chat. Déterminez ensuite les entités sources que vous souhaitez importer et mappez chacune d'elles sur une ressource Chat. Une fois que vous avez planifié les mappages de ressources, lisez les entités à partir de la plate-forme de messagerie source et écrivez-les dans des espaces en mode importation.