用途
gws-classroom 是 gws-claude-plugin 提供的一个技能,用于通过命令行工具 gws 操作 Google Classroom,实现对课程、成员名单和课程作业的管理。
前置条件
使用前需阅读 ../gws-shared/SKILL.md,了解认证方式、全局参数与安全规则。若该文件缺失,运行 gws generate-skills 生成。
主要能力
命令格式为:gws classroom <resource> <method> [flags]
覆盖的 API 资源包括:
- courses:创建、删除、获取、列出、更新课程,以及获取和更新评分周期设置。
- aliases、announcements、courseWork、courseWorkMaterials、posts、studentGroups、students、teachers、topics:分别对应别名、公告、课程作业、课程作业材料、帖子、学生分组、学生、教师、主题等资源的操作。
- invitations:接受、创建、删除、获取、列出邀请。
- registrations:创建、删除注册,用于让 Classroom 向指定的 Cloud Pub/Sub 主题发送通知。
- userProfiles:获取用户资料。
- guardianInvitations、guardians:监护人邀请与监护人相关操作。
使用方式
调用任何 API 方法前,先检查该方法:
浏览资源与方法
gws classroom --help
查看方法的必填参数、类型与默认值
gws schema classroom.<resource>.<method>
根据 gws schema 的输出构建 --params 与 --json 参数。
适用场景
适用于需要通过命令行或自动化方式管理 Google Classroom 课程、成员、邀请、课程作业与通知注册的场景,例如批量创建课程、管理学生与教师名单、发布课程作业、设置评分周期等。
限制
各方法在权限不足、资源不存在或参数无效时会返回相应错误码,如 PERMISSION_DENIED、NOT_FOUND、INVALID_ARGUMENT、FAILED_PRECONDITION 等。部分操作(如更新评分周期设置)要求请求用户与课程所有者具备相应许可资格。具体认证与安全规则需参考 gws-shared 技能文档。