Google Drive 助手

要解决的问题

把自动化脚本接到 Google Drive 上，通常意味着自己管 OAuth 的 client ID、刷新 token、维护 scope，还得为 v2/v3 的接口差异写适配。一旦凭证轮换或 scope 过期，脚本就开始随机失败，而且 token 落在日志里就是安全事故。oo-googledrive 的做法是把这部分甩给 OOMOL：凭证由服务端注入，本地只负责拼 payload 和读返回值。

它是如何工作的

这个技能不直接调 Drive API，而是通过 oo CLI 调用 googledrive connector，一共暴露 67 个 action。运行前建议先 inspect 契约拿到权威的输入输出 schema，再用匹配的 JSON 构造 --data。返回结构固定为 { "data": ..., "meta": { "executionId": "..." } }，执行 id 在 meta.executionId 里，方便做异步留痕和排障。

按职责可以把这 67 个 action 分成几组：

• 文件读写：upload_file、upload_update_file、edit_file、update_file、update_file_metadata_patch、download_file、export_google_workspace_file。其中 download_file 和 parse_file 在给出 mimeType 时走导出语义，可以拿 Google Workspace 原生文件的 transit URL。
• 检索与元数据：find_file、find_folder、get_file_metadata、get_about、get_permission_id_for_email。
• 分享与权限：create_permission、patch_permission、update_permission_patch、list_permissions、get_permission、delete_permission，覆盖用户、群组、域、 anyone 几种对象。
• 协作与评论：create_comment、create_reply、list_comments、list_replies、update_comment、update_reply、delete_comment、delete_reply。\n

Need to verify with the docs.

• 共享盘管理：create_drive、get_drive、list_shared_drives、hide_drive、update_drive、delete_drive 等。
• 变更同步：get_changes_start_page_token、list_changes 适合做增量同步。
• 版本与标签：list_revisions、get_revision、update_file_revision_metadata、list_file_labels、modify_file_labels。

组织数据时，create_folder 可以指定多个 parents 做跨目录挂载，move_file 则靠更新 parents 和 name 同时实现移动与重命名。为了拿到目标 ID，generate_ids 可以先批量申请，再在后续 create/copy 里复用。

适用边界与注意点

读类操作（get/list/find）可以直接跑；任何 create、update、send、post 类操作都会改变 Drive 状态，跑之前要把 payload 和预期效果跟用户确认清楚；delete / trash / remove 类操作是破坏性的，必须先确认目标 ID 并拿到明确批准。

凭证、scope 过期、额度不足（OOMOL_INSUFFICIENT_CREDIT）都属于一次性问题，只在命令真的报出对应错误时才走首次配置流程，不要每次调用前都重跑一遍。

另外注意一批 team_drive、copy_file 之类的 action 只是兼容性别名，语义上等价于 create_drive、copy_file_advanced 等新版接口，新代码里没必要再依赖它们。

典型场景

适合已经把 oo CLI 装好、登录过 OOMOL 并连好 Drive 的工程师，把 Drive 操作嵌进更大的自动化流程里，比如批量整理归档、给文件批量加评论、或者把共享盘的变更接到增量同步管道里。