SuperAPI AI 工具集

gws-classroom

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:该技能用于在命令行中调用 Google Classroom API,管理课程(courses)、邀请(invitations)、注册通知(registrations)和用户资料(userProfiles)等资源。

主要能力:courses 资源支持 create、delete、get、list、patch、update,以及 getGradingPeriodSettings 和 updateGradingPeriodSettings 评分周期设置;还包含 aliases、announcements、courseWork、courseWorkMaterials、posts、studentGroups、students、teachers、topics 等子资源操作。invitations 支持 accept、create、delete、get、list。registrations 支持 create、delete,用于将 Classroom 通知发送到 cloudPubSubTopic。userProfiles 支持 get,另有 guardianInvitations、guardians 资源。

使用方式:命令形式为 gws classroom <resource> <method> [flags]。调用前可运行 gws classroom --help 浏览资源与方法,运行 gws schema classroom.<resource>.<method> 查看必填参数、类型与默认值,再据此构建 --params 与 --json 标志。前置条件是阅读 ../gws-shared/SKILL.md 获取鉴权、全局标志与安全规则;若缺失则运行 gws generate-skills 生成。

适用场景:适合需要在终端或自动化流程中批量管理 Google Classroom 课程、成员名单与课程作业的用户。

限制:各方法受 Google Classroom API 权限约束,可能返回 PERMISSION_DENIED、NOT_FOUND、INVALID_ARGUMENT、FAILED_PRECONDITION 等错误;评分周期修改涉及许可要求,具体费用与配额资料暂未提供;注册创建中 expiry_time 与 id 的传入值会被忽略。