Google Tasks

核心用法

本技能提供Google Tasks API的完整代理访问能力，用户通过Maton网关即可执行任务管理操作。核心流程包括：获取MATON_API_KEY → 在ctrl.maton.ai创建Google Tasks OAuth连接 → 通过gateway.maton.ai代理调用原生Google Tasks API。

支持的操作覆盖：

• 任务列表管理：创建、查询、更新、删除任务列表
• 任务管理：创建子任务、设置截止日期、标记完成状态、批量清理已完成任务
• 高级功能：任务拖拽重排序、日期范围过滤、分页查询

API设计完全遵循Google Tasks REST API规范，返回数据结构与原API一致，开发者可直接参考Google官方文档。

显著优点

1. 零OAuth维护成本：无需搭建OAuth 2.0服务器、处理token刷新或管理client secret，Maton自动托管认证流程
2. 多连接管理：支持同时维护多个Google账号的任务连接，通过Maton-Connection头切换
3. 原生API兼容性：直接透传Google Tasks API，功能无裁剪，支持官方所有端点
4. 现成代码示例：提供Bash/Python/JavaScript完整代码片段，5分钟可跑通首个请求

潜在局限

1. 第三方依赖风险：服务可用性绑定Maton平台，若网关故障则无法访问Google Tasks
2. 数据隐私考量：任务数据流经Maton代理服务器，虽使用标准OAuth但仍需信任中间商
3. 速率限制叠加：受Google API配额与Maton网关双重限制，高频场景需关注429错误
4. 无实时同步：纯请求-响应模式，无Webhook或实时推送能力

适合人群

• 快速原型开发：需集成Google Tasks但不愿投入OAuth开发成本的个人开发者
• 自动化脚本编写：Python/Bash环境需批量操作任务数据的技术用户
• 多账号管理场景：代理、SaaS工具等需要操作多个Google账号任务的开发者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 认证泄露 | MATON_API_KEY泄露将导致账号内所有连接被滥用，需按密钥管理最佳实践存储 |

| 数据残留 | 删除Maton连接后，需确认是否同时撤销Google账号侧的OAuth授权 |

| 权限范围 | 连接创建时请求的OAuth scope包含全部Tasks权限，无法细粒度限制只读/只写 |

| 服务终止 | 若Maton停止运营，需自行迁移至原生Google API并重建OAuth流程 |

核心用法

Google Tasks Skill 是一个纯文档型(T-MD)API集成工具，通过 Maton 官方网关代理访问 Google Tasks REST API。用户需先在 maton.ai 注册获取 MATON_API_KEY，并通过 OAuth 流程授权 Google 账号，即可对任务清单(Task Lists)和任务(Tasks)执行完整的增删改查操作。

主要功能覆盖：

• 任务清单管理：创建、查询、更新、删除清单，支持分页获取
• 任务操作：创建任务(含子任务)、修改状态、设置截止日期、添加备注、移动排序、清空已完成任务
• 连接管理：通过 ctrl.maton.ai 管理多账号 OAuth 连接，支持指定连接 ID 切换账号

API 路径遵循 Google Tasks 原生结构，仅将 tasks.googleapis.com 替换为 gateway.maton.ai/google-tasks，Maton 网关自动注入 OAuth Token。

显著优点

| 维度 | 优势 |

|------|------|

| **安全架构** | 零代码执行风险，无依赖包，API 密钥通过环境变量管理，OAuth 凭证由 Maton 托管 |

| **接入便捷** | 无需自行搭建 OAuth 2.0 流程，一键授权即可调用完整 Google Tasks API |

| **功能完整** | 支持原生 API 全部能力：子任务层级、任务移动排序、截止日期筛选、完成状态批量清理 |

| **多账号支持** | 通过 `Maton-Connection` 头显式指定连接，方便多 Google 账号场景 |

| **传输安全** | 全链路 HTTPS/TLS 1.2+，符合企业级数据保护要求 |

潜在缺点与局限性

• 网络依赖：所有操作需实时连接 Maton 网关，离线无法使用
• 平台绑定：深度依赖 Maton 生态，若 Maton 服务变更可能影响可用性
• 配额限制：受 Google Tasks API 配额及 Maton 平台策略双重限制
• 无本地缓存：每次查询均需调用远端 API，高频场景需自行实现缓存层
• 错误调试：网关层可能屏蔽部分 Google API 原始错误信息，需结合连接状态排查

适合人群

• 需要快速集成 Google Tasks 但不愿维护 OAuth 2.0 代码的个人开发者
• 使用 AI Agent/自动化工作流管理待办事项的生产力用户
• 多 Google 账号任务管理的团队管理员
• 对代码执行安全性要求极高、偏好纯文档型工具的企业环境

常规风险

| 风险类型 | 说明 | 缓解措施 |

|----------|------|----------|

| **API 密钥泄露** | `MATON_API_KEY` 若写入代码或日志可能导致未授权访问 | 严格使用环境变量，定期轮换(建议90天)，使用专用密钥管理服务 |

| **OAuth 令牌过期** | 长期未使用可能导致连接失效 | 在 `ctrl.maton.ai` 监控连接状态，及时重新授权 |

| **域名钓鱼** | 误配置至非官方域名可能导致凭证窃取 | 验证仅使用 `gateway.maton.ai` 与 `ctrl.maton.ai` |

| **数据误删** | `DELETE` 操作不可逆，批量清理任务无二次确认 | 操作前验证 `taskId`/`tasklistId`，建议先备份关键数据 |

该 Skill 经 CLS-Certify v2.1.0 全量扫描，安全等级 S 级(95分)，适合生产环境部署。