GoodSync 中文文档 下载 App

Google Drive 与 Dropbox 对接 GoodSync

OAuth 2.0 授权流程

Google Drive 和 Dropbox 都使用 OAuth 2.0 作为授权机制。GoodSync 的配置过程对用户完全透明——只需要在弹出的浏览器窗口中登录并授权即可。

配置步骤（Google Drive 为例）

  1. 在 GoodSync 中创建或编辑作业
  2. 选择左侧或右侧端点类型为「Google Drive」
  3. 弹出浏览器窗口：
  1. 浏览器自动关闭，GoodSync 回到主界面
  2. 端点连接成功，可以浏览 Google Drive 中的文件

同样的流程适用于

授权令牌的管理

OAuth 授权完成后，GoodSync 会把 Access Token 和 Refresh Token 保存在本地设备上：

Google Drive 的特殊处理

Google Docs / Sheets / Slides 的处理

Google Drive 中有两类文件：

GoodSync 对 Google Workspace 文件的处理方式：

选项说明
导出为文件同步时把 Google Docs 导出为 .docx，Sheets 导出为 .xlsx
忽略不处理 Google Workspace 文件
创建快捷方式在目标端创建指向原始 Google Docs 的链接（需要 GoodSync Explorer 支持）

推荐使用「导出为文件」选项，同步后得到的 .docx/.xlsx 文件可以在本地打开和编辑。

Google Drive 的特殊目录

Google Drive 根目录下有一些特殊文件夹：

GoodSync 在选择 Google Drive 端点时会列出这些目录供你选择。

Google Drive 的 API 限流

Google Drive API 有每日请求配额限制（默认每个 OAuth 项目 10,000,000 请求/天）。GoodSync 在同步大量文件时可能触发限流。如果遇到 429 Too Many Requests 错误：

  1. 降低并行线程数
  2. 增加同步间隔（避免过于频繁的 Analyze/Sync）
  3. 考虑联系 Google 申请提高配额

Dropbox 的特殊处理

Dropbox Business Team Folders

GoodSync 不支持 Dropbox Business 的团队文件夹（Team Folders）。这是 Dropbox API 的限制，不是 GoodSync 的问题。如果你的 Dropbox 账户有团队文件夹，需要：

Dropbox 的增量同步优化

Dropbox API 支持增量变更列表功能（cursor-based listing）。GoodSync 会利用这个特性——下次分析时只对比上次同步后发生变更的文件，而不是全量列出整个云端目录。这对大目录（数万个文件）的同步分析速度提升明显。

与 GoodSync Connect 的配合

GoodSync v12 引入的账户数据云端同步特性，让 OAuth 授权变得更简单：

这个共享凭据机制同样适用于 Dropbox、OneDrive、Box.com 等所有 OAuth 型云存储。

云存储 vs 本地文件系统的差异

GoodSync 在对接云存储 API 时，需要适配云存储与本地文件系统的差异：

差异点本地文件系统Google Drive / DropboxGoodSync 的处理
文件标识路径云服务内部 IDGoodSync 维护路径 → ID 的映射
修改时间文件时间戳云服务的修改时间GoodSync 做时间戳翻译
权限文件系统权限云服务的共享权限不同步权限（可在高级选项中开启）
重命名原子操作需要先上传新版本再删除旧版分两步执行，中间状态有临时文件
并行上传直接写入云服务的多段上传 API利用并行上传提升速度

安全提示