Esegui la migrazione della tua organizzazione Google Workspace a Google Chat
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina fornisce una panoramica delle app di Google Chat che aiutano le organizzazioni Google Workspace a eseguire la migrazione a Google Chat da altre piattaforme di messaggistica.
In qualità di amministratore di Google Workspace, puoi creare un'app Chat che importa i dati di messaggistica da altre piattaforme di messaggistica. Per importare i dati, l'app Chat
crea risorse dell'API Chat
in base a messaggi, allegati, reazioni, adesioni
e spazi esistenti nella tua organizzazione.
Perché importare i dati durante la migrazione a Chat
L'importazione dei dati in Chat offre un'esperienza migliore agli utenti della tua organizzazione perché possono conservare la cronologia e il contesto delle piattaforme di messaggistica esistenti che utilizzano. Rispetto alla copia dei dati di origine
in spazi regolari, l'utilizzo degli spazi in modalità di importazione offre i seguenti
vantaggi:
Conservazione dei timestamp di creazione delle risorse. Puoi impostare un'ora storica per le ore di creazione delle risorse di spazi e messaggi, consentendo alle app di Chat di conservare il contesto storico durante l'adozione di Google Chat da parte degli utenti. Per saperne di più, consulta
Importare i dati di messaggistica in Google Chat.
Gli utenti finali non possono visualizzare o accedere agli spazi in modalità di importazione. Per impedire l'interferenza degli utenti in uno spazio in fase di importazione dei dati o per evitare possibili confusioni da parte degli utenti a causa della visualizzazione di un'importazione di dati in corso, gli spazi in modalità di importazione sono nascosti agli utenti finali. Una volta completata la modalità di importazione di uno spazio, puoi aggiungere utenti.
Chat disattiva le notifiche durante la modalità di importazione, in modo che gli utenti possano evitare avvisi non necessari sulla migrazione.
Risorse dell'API Google Chat che puoi creare per importare i dati di messaggistica
Per importare i dati di messaggistica, crei risorse API Chat in base ai dati di un'altra piattaforma di messaggistica. Puoi creare queste risorse negli spazi Chat in modalità di importazione. Puoi utilizzare gli spazi in modalità di importazione solo durante il processo di importazione.
Puoi creare le seguenti risorse dell'API Chat negli spazi in modalità di importazione:
Gli allegati possono essere caricati negli spazi in modalità di importazione con l'API Google Chat,
tuttavia consigliamo vivamente di utilizzare
l'API Google Drive
per caricare i file e collegare gli URI dei file ai rispettivi messaggi
negli spazi in modalità di importazione per evitare di raggiungere il limite interno di Google Chat
per il caricamento degli allegati.
I membership storici devono essere importati quando uno spazio è in modalità di importazione. Non puoi importare
le iscrizioni storiche dopo che lo spazio ha completato la modalità di importazione.
Gli altri abbonamenti esistenti della piattaforma di messaggistica di origine devono essere creati dopo che uno spazio ha completato la modalità di importazione.
I membri devono essere utenti dello stesso dominio.
Spazi.
Sono supportati solo SpaceType.SPACE e SpaceType.GROUP_CHAT.
Mappa i dati di origine alle risorse di Google Chat
Quando importi i dati dalle piattaforme di messaggistica di origine in Google Chat, esamina le risorse supportate che puoi creare in Chat. Quindi, determina le entità di origine che vuoi importare
e mappale ciascuna a una risorsa di Chat. Dopo aver pianificato le mappature delle risorse, leggi le entità dalla piattaforma di messaggistica di origine e scrivitele negli spazi in modalità di importazione.
Argomenti correlati
Per scoprire come autenticarti con l'API Chat quando utilizzi gli spazi in modalità di importazione, consulta Autorizzare le app di Google Chat.
[null,null,["Ultimo aggiornamento 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)."]]
