核心用法
本技能为 Google Tasks API 的托管网关，通过 Maton 平台实现 OAuth 2.0 认证代理。开发者无需直接对接 Google 的认证流程，仅需配置 MATON_API_KEY 并管理连接即可调用原生 Google Tasks API。
主要功能：
- 任务列表管理：创建、查询、更新、删除任务列表（TaskLists）
- 任务全生命周期管理：支持任务的增删改查、完成状态切换、子任务层级、任务移动与排序
- 过滤与分页：支持按完成状态、截止日期、更新时间筛选，以及分页令牌遍历大量数据
- 批量清理：一键清除已完成任务
调用方式：
# 基础调用模式 GET /google-tasks/tasks/v1/users/@me/lists Authorization: Bearer $MATON_API_KEY
连接管理：
- 通过
https://ctrl.maton.ai管理 OAuth 连接 - 支持多账户：使用
Maton-Connection头部指定特定连接 - 默认使用最早创建的活跃连接
显著优点
1. 零 OAuth 开发成本：封装了 Google OAuth 流程，无需处理 token 刷新、scope 申请、重定向等复杂逻辑
2. 原生 API 透传：直接代理 Google Tasks REST API，功能完整，文档与官方保持一致
3. 多语言示例丰富：提供 Python、JavaScript、curl 等多种调用示例
4. 企业级特性支持：任务层级（父子关系）、截止日期管理、完成时间追踪、Web 视图链接等完整字段
潜在缺点与局限性
1. 强依赖 Maton 平台：服务可用性与 Maton 网关绑定，存在供应商锁定风险
2. 网络访问必需：无法离线使用，所有操作需经 gateway.maton.ai 中转
3. 速率限制透明性：Google 的 quota 限制通过网关透传，但具体限制策略未明确说明
4. ID 不透明：任务 ID 为 base64 编码的字符串，可读性差，调试不便
5. 字符长度限制严格：标题 1024 字符、备注 8192 字符，超出即失败
适合人群
- 快速原型开发者：需要在数小时内集成 Google Tasks 功能，不愿投入 OAuth 开发
- 自动化脚本编写者：Python/Shell 用户希望通过简单 HTTP 调用管理个人或团队任务
- 多账户管理场景：需要同时操作多个 Google 账号的任务数据
- 现有 Google Workspace 用户：已深度使用 Google 生态，希望扩展任务自动化
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `MATON_API_KEY` 泄露可导致账户数据被访问 | 使用环境变量注入，避免硬编码；定期轮换密钥 |
| OAuth 授权范围 | 用户可能未细查授权范围即同意 | 在连接管理界面确认授权详情 |
| 数据删除不可逆 | DELETE 操作立即生效，无回收站 | 操作前确认 taskId，关键任务先备份 |
| 网关单点故障 | Maton 服务中断时完全不可用 | 关键业务应设计降级方案或保留原生 API 集成能力 |
| 时区/日期解析 | RFC 3339 时间戳需正确处理时区 | 使用标准库解析，避免字符串拼接 |
使用注意事项
- curl 特殊处理：URL 含方括号时需加
-g参数禁用 glob；管道至jq时环境变量可能无法展开 - PATCH vs PUT：PATCH 为部分更新，PUT 为全量替换，误用可能导致数据丢失
- 默认连接策略：未指定
Maton-Connection时使用最早连接，多账户场景务必显式指定