Google Tasks

核心用法

本技能为 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 时使用最早连接，多账户场景务必显式指定

核心用法

Google Tasks Skill 提供对 Google Tasks API 的完整代理访问能力，通过 Maton 网关实现托管 OAuth 认证。用户可执行以下操作：

• 任务列表管理：创建、读取、更新、删除任务列表（Task Lists）
• 任务管理：完整 CRUD 操作，支持子任务、截止日期、完成状态、备注字段
• 批量操作：分页查询、清除已完成任务、任务移动/重排序
• 连接管理：通过 ctrl.maton.ai 创建、查看、删除 OAuth 连接

所有请求通过 https://gateway.maton.ai/google-tasks/ 代理，自动注入 OAuth Token。需设置 MATON_API_KEY 环境变量进行认证。

显著优点

1. 托管 OAuth，降低集成成本：无需自行实现 Google OAuth 2.0 流程，Maton 代理处理 token 刷新与存储
2. 原生 API 完整覆盖：支持 Google Tasks v1 API 全部端点，包括 PATCH 部分更新、PUT 全量替换等精细操作
3. 多连接支持：可为同一 Google 账号或不同账号维护多个连接，通过 Maton-Connection 头部指定
4. 文档详尽：提供 Bash/Python/JavaScript 多语言示例，涵盖分页、错误处理、字段说明

潜在缺点与局限性

| 局限 | 说明 |

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

| 供应商锁定 | 依赖 Maton 网关（maton.ai），若服务中断需迁移至自建 OAuth 方案 |

| 网络依赖 | 所有操作需实时连接 Maton 网关与 Google API，无离线能力 |

| 无内置重试 | 代码示例未展示 429 限流后的指数退避重试逻辑 |

| Token 管理黑盒 | OAuth token 由 Maton 托管，用户无法直接查看或强制刷新 |

| 地域延迟 | 未说明网关服务器区域，跨国用户可能面临延迟 |

适合人群

• 需快速集成 Google Tasks 的开发者/团队，希望跳过 OAuth 实现
• 自动化工作流构建者（如通过脚本批量同步任务）
• 已使用 Maton 生态的其他服务用户

常规风险

1. API Key 泄露风险：MATON_API_KEY 若泄露，攻击者可访问该用户的全部 Google Tasks 数据
2. 中间人攻击：需确保 gateway.maton.ai 使用 TLS 1.2+，建议验证证书指纹
3. 权限范围：OAuth 授权时需确认 Maton 请求的权限范围，避免过度授权
4. 数据留存：任务数据流经 Maton 网关，需信任其隐私政策（当前未在文档中明确说明数据留存期限）