Skip to content

Google Drive ​

创建 OAuth 应用 ​

  1. 在 Google Cloud Console 创建项目。
  2. 启用 Google Drive API。
  3. 配置 OAuth 同意屏幕。
  4. 添加作用域:
    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/userinfo.profile
  5. 创建“Web 应用”OAuth 客户端。
  6. 添加重定向 URI,默认是 https://go-drive.top/oauth_callback。

如果使用测试状态的外部应用,refresh token 可能受 Google 测试应用政策限制。长期运行前应按账号类型和组织政策正确发布应用。

可使用自己的回调页:

yaml
oauth-redirect-uri: https://drive.example.com/oauth_callback

Google 控制台中的 URI 必须与配置完全一致。

添加 Google Drive 存储 ​

填写 Client ID、Client Secret 和缓存 TTL,完成 OAuth 后选择个人云端硬盘或共享云端硬盘,保存并重新加载存储配置。

缓存 TTL 默认 4h;外部直接修改文件后可清除缓存。Google 文件缩略图由 go-drive 拉取并写入缩略图缓存。

Google Drive API 没有传统路径模型,并允许同一目录存在同名文件。go-drive 遇到同名条目时会给名称追加文件 ID 的前 6 位。

Google 原生文件导出 ​

Google 类型下载格式
Docs 文档.docx
Sheets 表格.xlsx
Slides 演示.pptx
Drawing.svg
Apps Script.json

Google Drive 不支持原生复制文件夹,目录复制会由 go-drive 递归执行。

Google Cloud Console 界面会调整,但作用域和 go-drive 字段以上述当前实现为准。

基于 MIT 许可证发布。