核心功能
Google Classroom Skill 是基于 Maton 平台的托管式 OAuth 集成方案，为教育场景提供完整的 Google Classroom API 访问能力。核心功能涵盖六大模块：
课程管理 - 支持创建、查询、更新、归档及删除课程，可设置课程状态（ACTIVE/ARCHIVED）、分班、描述等元数据。课程需先归档后方可删除，符合 Google 的安全设计。
作业与课业（Course Work） - 完全支持 ASSIGNMENT、SHORT_ANSWER_QUESTION、MULTIPLE_CHOICE_QUESTION 三种作业类型。可设置发布状态（DRAFT/PUBLISHED）、分值、截止日期与时间，并支持批量查询和条件过滤。
学生提交物管理 - 追踪 NEW/CREATED/TURNED_IN/RETURNED/RECLAIMED_BY_STUDENT 五种提交状态，支持教师评分（assignedGrade/draftGrade 双轨制）和作业退回操作。
成员管理 - 教师与学生的增删改查，支持通过 email 邀请用户，自动解析用户 Profile 信息。
公告与主题 - 发布课程公告（支持草稿/发布状态），创建学习主题用于内容组织。
邀请与用户画像 - 管理课程邀请（STUDENT/TEACHER/OWNER 角色），获取当前用户权限与身份信息。
显著优势
| 维度 | 说明 |
|------|------|
| 零OAuth配置 | Maton 托管 OAuth 流程，用户只需浏览器授权，无需处理 token 刷新与存储 |
| 完整API覆盖 | 支持 Courses、CourseWork、StudentSubmissions、Teachers、Students、Announcements、Topics、Invitations 等全量资源 |
| 多连接管理 | 支持通过 `Maton-Connection` 头指定不同 Google 账号，适合代管多机构场景 |
| 标准REST接口 | 与官方 Google Classroom API 路径保持一致，降低迁移成本 |
| 分页与过滤 | 原生支持 pageToken 分页和字段级过滤，高效处理大规模数据 |
潜在局限
1. 网络依赖：必须通过 Maton 网关（gateway.maton.ai）访问，无法离线使用
2. 权限边界：受限于 Google OAuth 授权范围，无法访问超出用户授权的数据
3. 延迟考量：代理层增加一跳网络延迟，对实时性要求极高的场景需评估
4. updateMask 强制：PATCH 操作必须显式指定 updateMask，增加调用复杂度
5. 课程删除限制：必须先归档再删除，无法直接硬删除，需适配业务逻辑
适用人群
- 教育科技公司：需要批量管理多机构课程数据的 SaaS 服务商
- 学校IT管理员：自动化课程创建、师生账号同步、学期归档
- 在线教育平台：将 Google Classroom 作为底层基础设施，构建自有教学界面
- 开发者/集成商：快速原型验证教育类产品，避免 OAuth 基础设施投入
常规风险
| 风险类型 | 说明 | 缓解建议 |
|----------|------|----------|
| 密钥泄露 | MATON_API_KEY 泄露可能导致未授权访问 | 使用环境变量注入，避免硬编码；定期轮换密钥 |
| 权限蔓延 | 过度授权给 Maton 平台带来数据暴露面 | 最小权限原则，定期审计连接状态 |
| 速率限制 | Google API 存在配额限制（429错误） | 实现指数退避重试，监控配额使用 |
| 数据一致性 | 代理层缓存可能导致短暂数据不一致 | 关键操作后主动刷新，或设置合理缓存策略 |
| OAuth 断开 | 用户撤销授权导致连接失效 | 实现连接状态监控，优雅降级处理 |
技术细节补充
- 认证方式：Bearer Token（MATON_API_KEY）+ 托管 OAuth 2.0
- 连接管理：通过 ctrl.maton.ai 独立控制台管理多账号授权
- 日期格式：采用
{year, month, day}和{hours, minutes}结构化对象，非 ISO 8601 字符串 - 错误透传：4xx/5xx 错误直接透传 Google API 原始错误信息，便于调试