Migrer votre organisation Google Workspace vers Google Chat
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page présente les applications Google Chat qui aident les organisations Google Workspace à migrer vers Google Chat à partir d'autres plates-formes de messagerie.
En tant qu'administrateur Google Workspace, vous pouvez créer une application Chat qui importe les données de messagerie d'autres plates-formes de messagerie. Pour importer des données, l'application Chat crée des ressources de l'API Chat en fonction des messages, pièces jointes, réactions, adhésions et espaces existants dans votre organisation.
Pourquoi importer des données lors de la migration vers Chat ?
L'importation de données dans Chat offre une meilleure expérience aux utilisateurs de votre organisation, car ils peuvent conserver l'historique et le contexte des plates-formes de messagerie existantes qu'ils utilisent. Par rapport à la copie des données sources dans des espaces standards, l'utilisation d'espaces en mode importation présente les avantages suivants:
Conservation des codes temporels de création des ressources. Vous pouvez définir une date historique pour les dates de création des ressources de l'espace et des messages, ce qui permet aux applications Chat de conserver le contexte historique lorsque les utilisateurs passent à Google Chat. Pour en savoir plus, consultez la section Importer des données de chat dans Google Chat.
Les utilisateurs finaux ne peuvent pas voir les espaces en mode importation ni y accéder. Pour éviter que les utilisateurs interfèrent pendant l'importation des données, ou pour éviter aux utilisateurs de se poser des questions en voyant que des données sont en train d'être importées, les espaces en mode importation sont masqués pour les utilisateurs finaux. Lorsqu'un espace a quitté le mode importation, vous pouvez lui ajouter des utilisateurs.
Chat désactive les notifications pendant le mode importation, afin que les utilisateurs ne reçoivent pas d'alertes inutiles en rapport avec la migration.
Ressources de l'API Google Chat que vous pouvez créer pour importer des données de messagerie
Pour importer des données de messagerie, vous devez créer des ressources API Chat basées sur les données d'une autre plate-forme de messagerie. Vous créez ces ressources dans des espaces Chat en mode importation. Vous ne pouvez utiliser les espaces en mode importation que pendant le processus d'importation.
Vous pouvez créer les ressources d'API Chat suivantes dans les espaces en mode importation:
Pièces jointes, en suivant les recommandations suivantes :
Vous pouvez importer des pièces jointes dans des espaces en mode importation à l'aide de l'API Google Chat. Nous vous recommandons toutefois d'utiliser l'API Google Drive pour importer des fichiers et associer les URI de fichier aux messages correspondants dans les espaces en mode importation afin d'éviter d'atteindre la limite interne de Google Chat pour l'importation de pièces jointes.
Les adhésions historiques doivent être importées lorsqu'un espace est en mode importation. Vous ne pouvez pas importer les adhésions historiques lorsque l'espace n'est plus en mode importation.
Les autres adhésions existantes issues de la plate-forme de messagerie source doivent être créées une fois que l'espace a quitté le mode importation.
Les membres doivent être des utilisateurs du même domaine.
Espaces
Seuls SpaceType.SPACE et SpaceType.GROUP_CHAT sont acceptés.
Mapper les données sources sur les ressources Google Chat
Lorsque vous importez des données à partir de 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-les chacune à une ressource Chat. Une fois que vous avez planifié les mappages de ressources, lisez les entités de la plate-forme de messagerie source et écrivez-les dans des espaces en mode importation.
Articles associés
Pour savoir comment vous authentifier avec l'API Chat lorsque vous utilisez des espaces en mode importation, consultez Autoriser les applications Google Chat.
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 2024/12/03 (UTC).
[null,null,["Dernière mise à jour le 2024/12/03 (UTC)."],[[["\u003cp\u003eGoogle Chat apps can import messaging data (messages, attachments, reactions, memberships, spaces) from other platforms to Google Chat for Google Workspace users.\u003c/p\u003e\n"],["\u003cp\u003eImporting data preserves historical context and provides a better user experience during migration.\u003c/p\u003e\n"],["\u003cp\u003eImport mode spaces are used for data import and are hidden from end-users until the import is complete to prevent interference.\u003c/p\u003e\n"],["\u003cp\u003eChat apps have 90 days to import data into an import mode space before it's automatically deleted.\u003c/p\u003e\n"],["\u003cp\u003eGoogle recommends using Google Drive API for uploading attachments during import to avoid hitting Google Chat's internal limits.\u003c/p\u003e\n"]]],["Google Workspace administrators can create Chat apps to import data from other messaging platforms into Google Chat. These apps create Chat API resources like messages, attachments, reactions, memberships, and spaces within import mode spaces. This preserves historical context and user experience, hiding spaces during the import process and disabling notifications. Admins map data from the source platform to Chat resources and must complete the import within 90 days; otherwise, spaces are deleted. It is recommended to use the Google Drive API to handle attachment upload.\n"],null,["# Migrate your Google Workspace organization to Google Chat\n\nThis page provides an overview about Google Chat apps that help\nGoogle Workspace organizations migrate to Google Chat from other\nmessaging platforms.\n\nAs a Google Workspace administrator, you can create a\nChat app that imports messaging data from\nother messaging platforms. To import data, the Chat app\ncreates [Chat API resources](/workspace/chat/api/reference/rest)\nbased on existing messages, attachments, reactions, memberships,\nand spaces in your organization.\n\nWhy import data when migrating to Chat\n--------------------------------------\n\nImporting data to Chat provides a better experience for users\nin your organization because they can preserve history and context from\nexisting messaging platforms that they use. In comparison to copying source data\ninto regular spaces, the use of import mode spaces have the following\nadvantages:\n\n- Preservation of resource creation timestamps. You can set a historical time for the creation times of space and message resources, letting Chat apps retain historical context during user adoption of Google Chat. For more information, see [Import messaging data to Google Chat](/workspace/chat/import-data).\n- End users can't view or access spaces in import mode. To prevent user interference of a space undergoing data import, or to avoid possible user confusion as a result of viewing an in-progress data import, spaces in import mode are hidden from end users. After a space has completed import mode, you can add users to the space.\n- Chat turns off notifications during import mode, so that users can avoid unnecessary alerts about the migration.\n\nGoogle Chat API resources that you can create to import messaging data\n----------------------------------------------------------------------\n\nTo import messaging data, you create Chat API resources based on data\nfrom another messaging platform. You create these resources in *import mode*\nChat spaces. You can only use import mode spaces during the\nimport process.\n| **Warning:** After you've created an import mode\n| space, Chat apps have 90 days to complete the import of data for\n| a space. After 90 days, if the space is still in import mode, it's automatically\n| deleted and will be inaccessible and unrecoverable.\n\nYou can create the following Chat API resources in import mode spaces:\n\n- [Messages](/workspace/chat/api/reference/rest/v1/spaces.messages)\n- [Attachments](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) with the following considerations:\n - Attachments can be uploaded to import mode spaces with Google Chat API, **however we highly recommend using\n [Google Drive API](https://developers.google.com/drive/api/reference/rest/v3)\n to upload files and link the file URIs to the respective messages in\n the import mode spaces instead to avoid hitting Google Chat internal\n limit for attachment upload.**\n- [Reactions](/workspace/chat/api/reference/rest/v1/spaces.messages.reactions)\n- [Memberships](/workspace/chat/api/reference/rest/v1/spaces.members)\n with the following considerations:\n\n - [Historical memberships](/workspace/chat/import-data#historical_memberships) must be imported when a space is in import mode. You can't import historical memberships after the space completes import mode.\n - Other existing memberships from the source messaging platform must be created after a space completes import mode.\n - Members must be users within the same domain.\n- [Spaces](/workspace/chat/api/reference/rest/v1/spaces).\n Only `SpaceType.SPACE` and `SpaceType.GROUP_CHAT` are supported.\n\nMap source data to Google Chat resources\n----------------------------------------\n\nWhen importing data from source messaging platforms into Google Chat, review\nthe supported resources that you can create in\nChat. Then, determine the source entities that you want to import\nand map each one to a Chat resource. After you've planned the\nresource mappings, read the entities from the source messaging platform, and\nwrite them into import mode spaces.\n\nRelated topics\n--------------\n\n- To learn how to authenticate with Chat API when using import mode spaces, see [Authorize Google Chat apps](/workspace/chat/authorize-import).\n- To learn how to start importing resources using import mode spaces, see [Import messaging data to Google Chat](/workspace/chat/import-data)."]]
