이 페이지에서는 Google Workspace 조직이 다른 메시지 플랫폼에서 Google Chat으로 이전하는 데 도움이 되는 Google Chat 앱에 대해 간략히 설명합니다.
Google Workspace 관리자는 다른 메시지 플랫폼에서 메시지 데이터를 가져오는 Chat 앱을 만들 수 있습니다. 데이터를 가져오기 위해 Chat 앱은 조직의 기존 메시지, 첨부파일, 반응, 멤버십, 스페이스를 기반으로 Chat API 리소스를 만듭니다.
Chat으로 이전할 때 데이터를 가져오는 이유
Chat으로 데이터를 가져오면 조직의 사용자가 사용하는 기존 메시지 플랫폼의 기록과 맥락을 보존할 수 있으므로 더 나은 환경을 제공할 수 있습니다. 소스 데이터를 일반 스페이스에 복사하는 것과 비교할 때 가져오기 모드 스페이스를 사용하면 다음과 같은 이점이 있습니다.
리소스 생성 타임스탬프 보존 스페이스 및 메시지 리소스의 생성 시간에 대한 이전 시간을 설정하여 사용자가 Google Chat을 채택하는 동안 Chat 앱이 이전 컨텍스트를 유지하도록 할 수 있습니다. 자세한 내용은 Google Chat으로 메시지 데이터 가져오기를 참고하세요.
최종 사용자는 가져오기 모드에서 스페이스를 보거나 액세스할 수 없습니다. 데이터 가져오기를 진행 중인 스페이스에 사용자가 간섭하지 못하도록 하거나 진행 중인 데이터 가져오기를 보면서 사용자가 혼란스러워하는 것을 방지하기 위해 가져오기 모드의 스페이스는 최종 사용자에게 표시되지 않습니다. 스페이스의 가져오기 모드가 완료되면 스페이스에 사용자를 추가할 수 있습니다.
Chat은 가져오기 모드 중에 알림을 사용 중지하므로 사용자가 이전에 관한 불필요한 알림을 받지 않아도 됩니다.
메시지 데이터를 가져오기 위해 만들 수 있는 Google Chat API 리소스
메시지 데이터를 가져오려면 다른 메시지 플랫폼의 데이터를 기반으로 Chat API 리소스를 만듭니다. 이러한 리소스는 가져오기 모드 Chat 스페이스에서 만듭니다. 가져오기 프로세스 중에만 가져오기 모드 공백을 사용할 수 있습니다.
Google Chat API를 사용하여 가져오기 모드 스페이스에 첨부파일을 업로드할 수 있지만 Google Chat의 첨부파일 업로드 내부 한도가 적용되지 않도록 Google Drive API를 사용하여 파일을 업로드하고 가져오기 모드 스페이스의 각 메시지에 파일 URI를 연결하는 것이 좋습니다.
스페이스가 가져오기 모드일 때 이전 멤버십을 가져와야 합니다. 스페이스의 가져오기 모드가 완료된 후에는 이전 멤버십을 가져올 수 없습니다.
스페이스에서 가져오기 모드를 완료한 후에 소스 메시지 플랫폼의 다른 기존 멤버십을 만들어야 합니다.
구성원은 동일한 도메인에 속한 사용자여야 합니다.
스페이스SpaceType.SPACE 및 SpaceType.GROUP_CHAT만 지원됩니다.
소스 데이터를 Google Chat 리소스에 매핑
소스 메시지 플랫폼에서 Google Chat으로 데이터를 가져올 때 Chat에서 만들 수 있는 지원되는 리소스를 검토하세요. 그런 다음 가져올 소스 항목을 확인하고 각 항목을 Chat 리소스에 매핑합니다. 리소스 매핑을 계획한 후 소스 메시지 플랫폼에서 항목을 읽고 가져오기 모드 스페이스에 씁니다.
[null,null,["최종 업데이트: 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)."]]
