用途:通过 gws classroom 命令管理 Google Classroom 的课程、名册与课程作业。
主要能力: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 向 Cloud Pub/Sub 主题推送通知;userProfiles 支持 get,并含 guardianInvitations、guardians 子资源。
使用方式:先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则,缺失时运行 gws generate-skills 生成。命令格式为 gws classroom <resource> <method> [flags]。调用前可用 gws classroom --help 浏览资源与方法,用 gws schema classroom.<resource>.<method> 查看必填参数、类型和默认值,再据此构造 --params 与 --json。
限制:各方法有权限与错误码约束,如 PERMISSION_DENIED、NOT_FOUND、INVALID_ARGUMENT、FAILED_PRECONDITION;非管理员只能创建自己为所有者的课程;invitations 的 list 至少需提供 user_id 或 course_id 之一;registrations 的 expiry_time 与 id 会被忽略。成绩周期设置的修改需满足许可要求。具体认证配置与安全规则以 gws-shared 文档为准。