用途:通过命令行调用 Google Classroom API,管理课程、名册与课程作业。使用前需阅读 ../gws-shared/SKILL.md 获取认证、全局标志与安全规则;若文件缺失,运行 gws generate-skills 生成。
用法:命令格式为 gws classroom <resource> <method> [flags]。可先用 gws classroom --help 浏览资源与方法,再用 gws schema classroom.<resource>.<method> 查看必填参数、类型与默认值,据此构造 --params 与 --json。
主要能力:courses 支持 create、delete、get、list、patch、update,以及 getGradingPeriodSettings/updateGradingPeriodSettings;另有 aliases、announcements、courseWork、courseWorkMaterials、posts、studentGroups、students、teachers、topics 等子资源。invitations 支持 accept、create、delete、get、list(list 需至少提供 user_id 或 course_id)。registrations 支持 create、delete,用于向 Cloud Pub/Sub 主题推送通知。userProfiles 支持 get,并含 guardianInvitations、guardians 子资源。
限制:各方法在权限不足、对象不存在或参数无效时返回 PERMISSION_DENIED、NOT_FOUND、INVALID_ARGUMENT 等错误;非管理员用户创建课程时只能以自己为所有者;update 受 CourseNotModifiable、CourseTitleCannotContainUrl 等前置条件约束;评分周期设置需满足相应许可要求。详细错误码与返回字段见各方法文档。