gws-classroom
Installation
Summary
Google Classroom API integration for managing courses, rosters, assignments, and notifications.
- Covers courses (create, update, delete, list), invitations (accept, create, delete), and user profiles with full CRUD operations
- Supports nested resources including students, teachers, announcements, course work, topics, and student groups
- Includes grading period management and Cloud Pub/Sub registration for real-time notifications
- Requires
gwsbinary and Google Workspace authentication; usegws schemato inspect method parameters before execution
SKILL.md
classroom (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws classroom <resource> <method> [flags]
API Resources
courses
create— Creates a course. The user specified inownerIdis the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to create courses or for access errors. *NOT_FOUNDif the primary teacher is not a valid user.delete— Deletes a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to delete the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.get— Returns a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to access the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.getGradingPeriodSettings— Returns the grading period settings in a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user isn't permitted to access the grading period settings in the requested course or for access errors. *NOT_FOUNDif the requested course does not exist.list— Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request. Returned courses are ordered by creation time, with the most recently created coming first. This method returns the following error codes: *PERMISSION_DENIEDfor access errors. *INVALID_ARGUMENTif the query argument is malformed. *NOT_FOUNDif any users specified in the query arguments do not exist.patch— Updates one or more fields in a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *INVALID_ARGUMENTif invalid fields are specified in the update mask or if no update mask is supplied.update— Updates a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *FAILED_PRECONDITIONfor the following request errors: * CourseNotModifiable * CourseTitleCannotContainUrl
Related skills
More from googleworkspace/cli
gws-gmail
Gmail: Send, read, and manage email.
26.2Kgws-docs
Read and write Google Docs.
26.1Kgws-drive
Google Drive: Manage files, folders, and shared drives.
26.0Kgws-sheets
Google Sheets: Read and write spreadsheets.
24.7Kgws-calendar
Google Calendar: Manage calendars and events.
24.7Kgws-docs-write
Google Docs: Append text to a document.
21.8K