一、配置前必看：3 项核心前置条件

ABG 与 Google 服务的授权依赖特定环境与权限，需先确认以下条件满足，否则后续操作会直接受阻：

• DSM 版本要求：需安装 DSM 7.0 及以上版本（DSM 6.2 系列需升级后操作，旧版本不支持 ABG 的 Google 服务新授权逻辑）；

• ABG 套件要求：需在 DSM「套件中心」安装 Active Backup for Google Workspace 2.0 及以上版本（打开「套件中心」→搜索 “Active Backup for Google Workspace”，查看已安装版本，低于 2.0 需点击「更新」）。

配置需操作 Google Cloud 平台与 G Suite 管理后台，必须使用 Google Workspace 超级管理员账号（普通用户 / 部门管理员无权限创建项目、启用 API）：

• 验证方法：登录Google Workspace 管理后台，若左侧导航栏有 “安全”“API 控制” 选项，说明是超级管理员；若无，需联系企业 G Suite 管理员获取权限。

ABG 需通过网络访问 Google Cloud API，需确认：

• DSM 所在 NAS 可正常访问外网（测试方法：在 DSM「控制面板」→「网络」→「网络界面」，点击「诊断」→「Ping 测试」，输入 “google.com”，若显示 “Ping 成功”，说明网络连通）；

• 若 NAS 处于企业内网（有防火墙 / 代理），需开放 Google Cloud 相关域名（如*.googleapis.com、accounts.google.com），避免端口或域名被屏蔽导致授权失败。

Google Cloud 是 ABG 获取 Google 服务授权的 “桥梁”，需在此创建项目、启用必需 API、配置 OAuth 客户端，每一步均需严格按要求设置，否则后续授权会报错。

项目是 Google Cloud 资源的管理单元，创建独立项目可避免与其他业务（如企业其他 API 应用）冲突：

1. 登录Google Cloud 控制台，使用 Google Workspace 超级管理员账号登录；

2. 点击页面顶部 “项目选择器”（默认显示 “我的第一个项目”），在弹出窗口中点击「新建项目」；

3. 填写项目信息：

• • 「项目名称」：建议包含 “Synology ABG” 字样，便于识别，如 “Synology-ABG-Backup-Project”；

• • 「组织」：选择企业对应的 Google Workspace 组织（若无可留空，但需确保后续 API 权限正常）；

• • 「位置」：默认选择 “no organization” 或企业所在区域（如 “Asia-Pacific”），不影响功能；

4. 点击「创建」，等待项目创建完成（约 10-30 秒，页面会自动跳转至新项目控制台）。

ABG 需调用 Google 特定 API 才能读取 G Suite 数据，必须启用以下 6 个 API（缺一不可），步骤如下：

1. 在 Google Cloud 控制台左侧导航栏，点击「菜单」→「API 和服务」→「库」；

2. 在 API 库搜索框中，依次搜索以下 API，找到后点击「启用」（每个 API 需单独启用）：

• • Admin SDK API：用于访问 Google Workspace 用户信息、组织架构；

• • Google Drive API：用于备份用户 Google Drive 文件；

• • Gmail API：用于备份用户 Gmail 邮件；

• • Calendar API：用于备份用户日历数据；

• • People API：用于备份用户联系人数据；

• • Tasks API：用于备份用户任务数据；

3. 启用完成后，可在「API 和服务」→「已启用的 API 和服务」中查看，确认 6 个 API 均显示 “已启用”（若有遗漏，需重新搜索启用）。

OAuth 同意屏幕是 ABG 请求 Google 授权时，用户看到的 “信任确认页面”，需配置企业信息确保用户（管理员）愿意授权：

1. 在 Google Cloud 控制台左侧导航栏，点击「API 和服务」→「OAuth 同意屏幕」；

2. 选择「用户类型」：

• • 若企业使用自有 Google Workspace 组织，选择「内部」（仅组织内用户可授权，更安全）；

• • 若无可选组织，选择「外部」（需 Google 审核，审核周期约 1-3 天，不推荐企业使用）；

3. 点击「创建」，进入 “应用信息” 配置页：

• • 「应用名称」：填写 “Synology ABG Backup”（用户授权时会看到）；

• • 「用户支持电子邮件」：选择超级管理员邮箱（用于接收用户反馈）；

• • 「应用徽标」：可选，建议上传 Synology 或 ABG 相关图标（增强信任）；

• • 「开发者联系电子邮件」：填写与用户支持邮箱一致的地址；

4. 点击「保存并继续」，跳过 “范围” 配置（后续在 DSM 中设置），直接进入 “测试用户” 页面：

• • 点击「添加用户」，输入 Google Workspace 超级管理员邮箱（仅测试用户可授权，避免全员可见）；

5. 点击「保存并继续」，完成 OAuth 同意屏幕配置。

OAuth 客户端 ID 是 DSM 的 ABG 套件与 Google 服务通信的 “身份凭证”，需准确配置重定向 URI（关键参数，错填会导致授权失败）：

1. 在 Google Cloud 控制台左侧导航栏，点击「API 和服务」→「凭据」；

2. 点击页面顶部「创建凭据」→选择「OAuth 客户端 ID」；

3. 选择「应用类型」：必须选择 “Web 应用”（DSM 的 ABG 通过 Web 端发起授权请求，选其他类型会报错）；

4. 配置 “已获授权的重定向 URI”（核心！需复制 DSM 的 ABG 授权回调地址）：

• • 先打开 DSM 管理界面，进入「Active Backup for Google Workspace」→点击左侧「备份目标」→选择「Google Workspace」→点击「配置 Google 服务」；

• • 在弹出的 “配置 Google 服务” 窗口中，复制 “重定向 URI”（格式为：https://[DSM的IP或域名]:[端口]/activebackupgoogle/oauth2callback，如https://192.168.1.100:5001/activebackupgoogle/oauth2callback）；

• • 回到 Google Cloud 控制台，将复制的 URI 粘贴到「已获授权的重定向 URI」→点击「添加」；

5. 点击「创建」，弹出 “OAuth 客户端创建成功” 窗口，立即复制 “客户端 ID” 和 “客户端密钥”（后续 DSM 配置需用，关闭窗口后可在「凭据」页面重新查看，但建议立即保存到记事本）。

Google Cloud 配置完成后，需在 DSM 的 ABG 中填入客户端信息，发起授权请求，完成最终连接：

1. 回到 DSM 的「Active Backup for Google Workspace」→「备份目标」→「Google Workspace」→「配置 Google 服务」窗口；

2. 在 “客户端 ID” 框中，粘贴 Google Cloud 创建的 “OAuth 客户端 ID”（注意：不要包含空格，区分大小写）；

3. 在 “客户端密钥” 框中，粘贴 Google Cloud 创建的 “OAuth 客户端密钥”（同样需准确，错 1 个字符都会失败）；

4. 点击「下一步」，系统会自动跳转到 Google 授权页面。

1. 在 Google 授权页面，使用 Google Workspace 超级管理员账号登录（必须与创建 Cloud 项目的账号一致）；

2. 点击「允许」，授权 ABG 访问 “查看和管理 Gmail/ Drive / 日历 / 联系人” 等权限（若不勾选全部权限，会导致部分数据无法备份）；

3. 授权完成后，页面会自动跳转回 DSM 的 ABG 配置页，显示 “Google 服务配置成功”（若未自动跳转，检查重定向 URI 是否正确，或手动关闭页面重新发起）。

1. 配置成功后，进入 “访问范围” 设置页，选择 ABG 可访问的 Google Workspace 数据范围：

• • 「整个组织」：备份企业所有 G Suite 用户数据（适合管理员统一管理）；

• • 「特定部门」：仅备份指定部门用户数据（需在 Google Workspace 管理后台创建部门，再在此选择）；

• • 「特定用户」：仅备份指定用户数据（需输入用户邮箱，适合小范围测试）；

2. 点击「保存」，完成 DSM 端 ABG 与 Google 服务的连接配置。

配置完成后需立即验证，确保 ABG 已正常获取 Google 服务权限，避免等到备份时才发现问题：

1. 在 DSM 的 ABG 中，点击左侧「备份源」→「Google Workspace 用户」；

2. 若页面显示企业 G Suite 用户列表（包含用户名、邮箱、部门），说明 ABG 已成功读取用户数据，授权有效；

3. 若显示 “无用户数据” 或 “连接失败”，需检查：Google Cloud API 是否全部启用、OAuth 授权是否完成、网络是否连通。

1. 点击 ABG 左侧「备份任务」→「创建」；

2. 选择 “备份源” 为 “Google Workspace 用户”，勾选 1-2 个测试用户；

3. 选择 “备份目标” 为 DSM 的本地卷（如 Volume 1），设置备份名称（如 “ABG-Test-Backup”）；

4. 点击「下一步」→「完成」，启动测试备份任务；

5. 观察任务状态：若显示 “运行中” 或 “已完成”，且无 “授权错误”“API 错误” 提示，说明配置完全成功；若失败，查看「日志」获取错误信息（如 “API 未启用”“权限不足”）。

配置过程中易因参数错填、权限不足导致失败，以下是官方推荐的解决方案：

1. 定期检查 API 状态：Google Cloud 可能因政策调整禁用未使用的 API，建议每月登录「已启用的 API」页面，确认 6 个必需 API 均正常（若被禁用，重新启用）；

2. 备份 OAuth 客户端信息：将 “客户端 ID”“客户端密钥” 保存到企业文档，若后续 DSM 重置或 ABG 重装，需重新填入；

3. 避免频繁修改项目：Google Cloud 项目删除后，已配置的 ABG 授权会失效，需重新走全流程，建议创建后不要随意删除；

4. 监控 API 配额：部分 Google API 有免费配额（如 Drive API 每月 100 万次请求），若企业用户多、备份频繁，需在 Google Cloud「配额」页面查看使用情况，避免配额耗尽导致备份中断。

为 Synology ABG 准备 Google 服务的核心是 “Google Cloud 配置 + DSM 授权” 两步，其中 Google Cloud 的 API 启用、OAuth 重定向 URI 配置，以及 DSM 的客户端信息填写是关键 —— 只要严格按步骤操作，确保参数准确、权限充足，即可顺利完成授权。配置后通过 “读取用户列表”“测试备份” 验证效果，遇到问题参考高频错误解决方案，可大幅降低故障耗时。

若需进一步了解 ABG 的备份策略设置（如增量备份、保留周期），可参考 Synology 官方教程（https://kb.synology.cn/zh-cn/DSM/tutorial/Preparing_Google_for_using_ABG），获取更全面的 ABG 使用指南。