核心用法
本 Skill 提供通过 Maton 网关访问 Google Tasks API 的能力，采用托管 OAuth 方案，用户无需自行处理复杂的 Google OAuth 流程。开发者只需获取 Maton API Key，即可通过标准 REST API 对任务列表（Task Lists）和任务（Tasks）进行增删改查操作。
主要功能模块
1. 连接管理：通过 ctrl.maton.ai 接口创建、查看、删除 Google Tasks OAuth 连接，支持多连接场景下的指定使用
2. 任务列表操作：完整的列表 CRUD——创建、获取、更新（PATCH/PUT）、删除任务列表
3. 任务操作：支持任务的创建、查询（含多条件过滤）、更新、删除、移动位置、批量清除已完成任务
4. 分页支持：通过 maxResults 和 pageToken 参数处理大量数据
显著优点
- 零 OAuth 配置成本：Maton 托管认证流程，开发者跳过 Google Cloud Console 配置、重定向 URI 设置等繁琐步骤
- 原生 API 透传：网关直接代理请求至
tasks.googleapis.com，保留 Google 官方 API 的所有字段和行为 - 多语言示例完善：提供 Python、JavaScript、Bash/curl 的完整代码示例，降低接入门槛
- 连接灵活管理：支持多账户场景，可通过
Maton-Connection头部切换不同 Google 账号
潜在缺点与局限性
- 供应商锁定风险：依赖 Maton 网关服务，若服务中断或策略变更将影响使用；无法直接调用 Google API
- 网络依赖严格：所有请求必须经过
gateway.maton.ai，不支持离线或私有网络部署 - 功能边界受限：仅覆盖 Tasks API，不涉及 Google Calendar、Keep 等其他 Workspace 服务
- 调试复杂度：OAuth 问题需通过 Maton 控制面板诊断，错误信息可能经过网关封装
适合人群
- 需要快速集成 Google Tasks 的独立开发者、小型团队
- 不愿投入时间维护 OAuth 认证基础设施的项目
- 以 Python/JavaScript 为主要技术栈的后端或自动化脚本开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 认证泄露 | `MATON_API_KEY` 泄露将导致所有绑定的 Google Tasks 数据暴露，需妥善保管 |
| 速率限制 | 受 Google Tasks API 配额限制（默认 500 请求/项目/秒），大规模应用需申请提升配额 |
| 数据隐私 | 任务数据流经 Maton 网关，需评估第三方托管的合规性要求 |
| 令牌过期 | 托管 OAuth 令牌由 Maton 维护，若刷新失败将导致连接失效 |
> 重要提示：文档特别指出 curl 管道至 jq 时可能出现环境变量展开问题，以及含方括号 URL 需用 curl -g 禁用 glob 解析，这些细节在调试时需特别注意。