SuperAPI AI 工具集

google-workspace

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:在 Hermes 智能体中通过统一脚本访问 Gmail、Google 日历、Drive、通讯录、Sheets 和 Docs,适合需要读取或操作 Google Workspace 数据的自动化场景。

主要能力:Gmail 支持搜索(is:unread、from:、newer_than: 等语法)、读取正文、发送、回复、查看与修改标签;日历支持列出、创建和删除事件,时间须为带时区的 ISO 8601;Drive 支持搜索、读取元数据、上传、下载(Google 原生文件导出为 pdf/csv 等默认格式)、创建文件夹、共享与删除(默认进回收站);通讯录支持列表;Sheets 支持新建、读取、更新、追加;Docs 支持读取、新建和追加文本。所有命令返回 JSON。

使用方式:先运行 setup.py --check 确认是否已认证;首次需创建 Google Cloud OAuth 客户端(桌面应用类型)并启用相应 API,再依次执行 --client-secret、--auth-url、--auth-code、--check。认证令牌存放于 ~/.hermes/google_token.json 并自动刷新。日常通过 scripts/google_api.py 的子命令(gmail/calendar/drive/contacts/sheets/docs)调用;若 gws 已安装则优先使用,且复用同一凭据。撤销授权用 --revoke。

限制:发送邮件、创建或删除日历事件、删除 Drive 文件、共享文件、修改 Docs/Sheets 前必须先与用户确认。日历时间必须带时区。高级保护账号需管理员将 OAuth 客户端 ID 加入组织允许列表。缺失的 API 或 scope 会报 403 或权限错误,需重新授权。资料未提供具体价格或收费信息。