skilld
All skills
googleworkspace avatar

/gws-classroom

@705fb0e
by Google Workspacegoogleworkspace/cli31k stars
1,856

Google Classroom: Manage classes, rosters, and coursework.

Ask your Agent

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-classroom

This session only. Nothing lands on disk.

SKILL.md

≈18 tokens always: the name and description. ≈1.7k when used: this file.

classroom (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws classroom <resource> <method> [flags]

API Resources

courses

  • create — Creates a course. The user specified in ownerId is 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_DENIED if the requesting user is not permitted to create courses or for access errors. * NOT_FOUND if the primary teacher is not a valid user.
  • delete — Deletes a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to delete the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID.
  • get — Returns a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to access the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID.
  • getGradingPeriodSettings — Returns the grading period settings in a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user isn't permitted to access the grading period settings in the requested course or for access errors. * NOT_FOUND if 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_DENIED for access errors. * INVALID_ARGUMENT if the query argument is malformed. * NOT_FOUND if 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_DENIED if the requesting user is not permitted to modify the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID. * INVALID_ARGUMENT if 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_DENIED if the requesting user is not permitted to modify the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID. * FAILED_PRECONDITION for the following request errors: * CourseNotModifiable * CourseTitleCannotContainUrl
  • updateGradingPeriodSettings — Updates grading period settings of a course. Individual grading periods can be added, removed, or modified using this method. The requesting user and course owner must be eligible to modify Grading Periods. For details, see licensing requirements.
  • aliases — Operations on the 'aliases' resource
  • announcements — Operations on the 'announcements' resource
  • courseWork — Operations on the 'courseWork' resource
  • courseWorkMaterials — Operations on the 'courseWorkMaterials' resource
  • posts — Operations on the 'posts' resource
  • studentGroups — Operations on the 'studentGroups' resource
  • students — Operations on the 'students' resource
  • teachers — Operations on the 'teachers' resource
  • topics — Operations on the 'topics' resource

invitations

  • accept — Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. Only the invited user may accept an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to accept the requested invitation or for access errors.
  • create — Creates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to create invitations for this course or for access errors. * NOT_FOUND if the course or the user does not exist. * FAILED_PRECONDITION: * if the requested user's account is disabled.
  • delete — Deletes an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to delete the requested invitation or for access errors. * NOT_FOUND if no invitation exists with the requested ID.
  • get — Returns an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to view the requested invitation or for access errors. * NOT_FOUND if no invitation exists with the requested ID.
  • list — Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. Note: At least one of user_id or course_id must be supplied. Both fields can be supplied. This method returns the following error codes: * PERMISSION_DENIED for access errors.

registrations

  • create — Creates a Registration, causing Classroom to start sending notifications from the provided feed to the destination provided in cloudPubSubTopic. Returns the created Registration. Currently, this will be the same as the argument, but with server-assigned fields such as expiry_time and id filled in. Note that any value specified for the expiry_time or id fields will be ignored.
  • delete — Deletes a Registration, causing Classroom to stop sending notifications for that Registration.

userProfiles

  • get — Returns a user profile. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to access this user profile, if no profile exists with the requested ID, or for access errors.
  • guardianInvitations — Operations on the 'guardianInvitations' resource
  • guardians — Operations on the 'guardians' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws classroom --help

# Inspect a method's required params, types, and defaults
gws schema classroom.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides a command-line interface for the 'gws' tool to manage Google Classroom resources. It is a legitimate administrative tool and does not contain any malicious code, obfuscation, or unauthorized data access patterns.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 705fb0e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 6 months ago

Capability

Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws classroom --help"
  }
}

Topics

  • CLI
  • google-classroom
  • google-workspace
  • classroom-management
  • education
  • rosters
  • coursework
  • gws

README badge

README badge for googleworkspace/cli/gws-classroom

What it does

Wraps the Google Classroom API to manage courses, rosters, assignments, and grading via CLI. Requires the gws CLI tool and Google Workspace authentication, and supports operations like creating courses, managing students and teachers, and configuring grading periods.

Generated from the current SKILL.md.

Frequently asked

What authentication does this skill require?
The skill requires the gws CLI tool and authentication configured through gws-shared/SKILL.md. Read the shared skill first for auth setup and security rules.
Can I create courses for other users?
Non-admin users can only create courses with themselves as owner. Domain admins can create courses owned by any user within their domain.
What Google Classroom resources does this skill support?
The skill covers courses, invitations, registrations, and user profiles, with sub-resources like announcements, courseWork, students, teachers, topics, and guardian management.
How do I discover available methods and parameters?
Use `gws classroom --help` to browse resources and methods, then `gws schema classroom.<resource>.<method>` to inspect required params and types before building your command.

Generated from the current SKILL.md. These answers refresh after source changes.