gws-classroom

Manage Google Classroom courses, rosters, and coursework via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-classroom-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-classroom
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-classroom
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-classroom-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Classroom programmatically requires navigating a large REST API surface. This Skill maps the Classroom API to a consistent CLI pattern so you can create courses, manage rosters, post coursework, and handle invitations without writing raw API calls. ## Core Features & Use Cases - Course Management: Create, update, list, and delete courses, plus manage grading period settings and course aliases. - Roster & People Operations: Add or remove students and teachers, send and accept invitations, and manage guardians. - Coursework & Content: Work with announcements, courseWork, courseWorkMaterials, topics, and posts. - Use Case: A school administrator needs to provision 30 new classes at the start of a semester. Use this Skill to script course creation, assign teachers, and enroll student rosters in bulk. ## Quick Start Ask the assistant to list all active Google Classroom courses for your account using the gws classroom CLI.

Frequently Asked Questions about gws-classroom

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Google Classroom course from the command line?

Run gws classroom courses create with the required parameters such as name and ownerId. Inspect required fields first with gws schema classroom.courses.create to build the correct --params or --json flags.

How to list students enrolled in a Google Classroom course?

Use the students resource under courses with the list method, passing the course ID. Run gws schema classroom.courses.students.list to see the exact parameters the method accepts.

Can I manage Google Classroom guardians and invitations via CLI?

Yes, the userProfiles resource exposes guardians and guardianInvitations operations, and the invitations resource supports create, accept, delete, get, and list. Note that only the invited user can accept an invitation.

Why does gws classroom return PERMISSION_DENIED errors?

PERMISSION_DENIED means the authenticated user lacks rights for that operation, such as modifying another teacher's course or creating courses for other owners. Verify the authenticated account's role and domain admin status.

What are the limitations of creating courses as a non-admin user?

A non-admin user can only create courses with themselves as the owner. Domain admins can create courses owned by any user within their domain, so bulk provisioning for other teachers requires admin credentials.