迁移google workspace数据需依目标平台选择路径：一、用microsoft migration manager批量迁移全量数据；二、imap仅迁邮箱；三、kernel工具支持增量与筛选；四、zoho向导原生集成；五、powershell+api自定义脚本。
如果您需要将 Google Workspace 中的数据从一个环境转移到另一个环境，例如迁移到 Microsoft 365、Zoho Mail 或其他云平台，则必须依据目标系统要求配置权限、验证域并执行结构化迁移流程。以下是完成该任务的多种可行路径：
一、使用 Migration Manager 迁移至 Microsoft 365
Migration Manager 是 Microsoft 官方提供的集成式迁移工具，支持对 Gmail、Drive、Calendar、Contacts 和 Tasks 的批量迁移，并自动处理元数据与权限映射。
1、以 Microsoft 365 全局管理员身份登录 Microsoft 365 管理中心，导航至“迁移” > “迁移到 Microsoft 365”。
2、选择“Google Workspace”作为源，点击“开始迁移”，系统将引导您安装 Microsoft 365 迁移应用到 Google 工作区市场。
3、使用 Google 域超级管理员账号授权该应用访问 Gmail、Drive、Calendar、People API 等服务。
4、在 Migration Manager 中添加要扫描的 Google 用户或整个组织单位（OU），启动扫描作业。
5、扫描完成后下载并审阅“扫描报告”，确认无 OAuth 范围缺失、文件大小超限或共享权限不兼容 等阻塞项。
6、将通过扫描验证的用户添加至迁移列表，配置目标路径映射和用户/群组标识映射关系。
7、启动迁移作业，通过实时仪表板监控进度，迁移状态将显示为“正在运行”“已完成”或“已失败”。
二、通过 IMAP 协议迁移邮箱数据
IMAP 迁移适用于仅需转移电子邮件内容的轻量级场景，无需依赖 Google API 权限配置，但不支持日历、联系人或 Drive 文件同步。
1、确保 Google Workspace 用户已启用两步验证，并为每个账户生成专用的 应用专用密码（而非常规登录密码）。
2、在 Microsoft 365 管理中心进入“迁移” > “迁移到 Microsoft 365” > “设置 IMAP 迁移”。
3、输入源邮箱地址、IMAP 服务器地址（imap.gmail.com）、端口（993）、加密方式（SSL/TLS）及应用专用密码。
4、指定目标 Microsoft 365 用户邮箱地址，系统将自动创建迁移批次。
5、启动迁移后，Microsoft 365 将按顺序拉取邮件，每封邮件保留原始时间戳与文件夹归属关系。
6、迁移结束后，可在目标邮箱的“已迁移邮件”文件夹中查看全部导入内容，原始标签将转换为 Outlook 文件夹结构。
三、借助 Kernel Google Workspace to Office 365 工具迁移
Kernel 工具提供图形化界面与高级筛选能力，支持选择性迁移、增量迁移及 CSV 批量映射，适合含复杂权限结构或大型组织的迁移需求。
1、下载并安装 Kernel Google Workspace to Office 365 迁移软件至 Windows 本地工作站。
2、启动软件后选择“Google Workspace”作为源，输入域管理员凭据及已导出的 JSON 服务密钥文件路径。
通过 SerpApi 查询 Google Flights，获取航班时刻表、价格及舱位等级信息。当用户询问航班 / 机票 / 航班价格、时刻表或对比信息时使用。
3、在“选择迁移项目”界面勾选需迁移的数据类型：Gmail、Contacts、Calendar、Tasks、Google Chat、Drive 文件夹等。
4、点击“导出 CSV”生成用户映射模板，编辑 CSV 文件中的源邮箱与目标 Exchange Online 邮箱对应关系，保存后使用“导入 CSV”功能加载。
5、在“迁移选项”中启用 “如果目标已存在则跳过” 以执行增量迁移，避免重复写入。
6、设置日期范围筛选器，仅迁移某一时段内创建或修改的 Drive 文件。
7、点击“开始迁移”，软件将显示各邮箱的独立进度条及错误日志，迁移完成后生成详细报告。
四、使用 Zoho Mail 迁移向导导入 Google Workspace 数据
Zoho Mail 提供原生迁移向导，专为从 Google Workspace 切换至 Zoho 生态设计，涵盖邮件、联系人、日历及 MX 记录配置全流程。
1、以 Zoho Mail 管理员身份登录 Zoho 控制台，进入“邮件管理” > “迁移” > “Google Workspace”。
2、添加并验证您的域名，确保 DNS 中已正确配置 CNAME 和 TXT 记录用于所有权校验。
3、点击“授权访问”，系统跳转至 Google OAuth 页面，使用 Google 域超级管理员账号授予以下权限：https://www.googleapis.com/auth/admin.directory.user, https://mail.google.com, https://www.googleapis.com/auth/calendar。
4、在“用户导入”页面选择待迁移的 Google 用户列表，系统将自动提取其邮箱、姓名、部门等属性并创建 Zoho 对应账户。
5、更新域名的 MX 记录指向 Zoho 邮件服务器（如 mx.zohomail.com），生效后新邮件将直接投递至 Zoho。
6、启动迁移任务，Zoho 后台将并行拉取 Gmail、Google Contacts 和 Google Calendar 数据，保留原始分类与提醒设置。
五、通过 PowerShell + Admin SDK 执行自定义迁移
对于具备开发能力的管理员，可利用 Google Admin SDK 和 Microsoft Graph API 编写脚本实现细粒度控制，例如按 OU 分批迁移、过滤特定标签邮件或同步资源邮箱配置。
1、在 Google Cloud Console 中启用 Admin SDK、Gmail API、Directory API，并为服务账号配置全网域委派权限。
2、使用 PowerShell 安装 Google.Apis.Admin.Directory directory_v1 和 Microsoft.Graph.Users 模块。
3、调用 UsersResource.ListRequest 获取 Google 域内全部用户列表，筛选出目标 OU 下的活跃账户。
4、对每个用户调用 GmailResource.Users.Messages.List 方法，分页获取 Message ID 列表，再逐条调用 Get 方法提取原始 MIME 内容。
5、将 MIME 数据封装为 RFC 822 格式，通过 Microsoft Graph 的 CreateMessage 接口 POST 至对应目标用户的 mailbox。
6、使用 Invoke-RestMethod 提交日历事件请求至 https://graph.microsoft.com/v1.0/users/{id}/calendar/events，同步原始 start/end 时间与时区信息。
