# Gws Classroom > Google Classroom: Manage classes, rosters, and coursework. Source: https://skillsagentes.com/skills/googleworkspace/cli/gws-classroom Repository: https://github.com/googleworkspace/cli Author: googleworkspace License: Apache-2.0 Updated: hace 4 meses Context cost: 15 tok installed, 1.7k tok once triggered, 1.7k tok with every bundled file Bundle: 1 file, 7 KB Permissions requested: none declared ## Install ```bash npx -y skills add googleworkspace/cli --skill gws-classroom --agent claude-code ``` ## What it does - Gestiona cursos de Google Classroom: crear, actualizar, listar, eliminar y consultar configuración de periodos de calificación - Administra invitaciones a cursos (crear, aceptar, listar, eliminar) para profesores y estudiantes - Maneja perfiles de usuario, tutores (guardians) y sus invitaciones - Gestiona anuncios, tareas (courseWork), materiales, publicaciones, temas y grupos de estudiantes dentro de un curso - Crea y elimina registros (registrations) para notificaciones vía Cloud Pub/Sub ## Use it when - Necesitas crear, listar, actualizar o eliminar cursos de Google Classroom desde la CLI - Necesitas gestionar invitaciones, profesores, estudiantes o tutores de un curso - Necesitas inspeccionar recursos y métodos disponibles con `gws classroom --help` o `gws schema` ## What triggers it - "Crea un nuevo curso en Google Classroom con este profesor como owner" - "Lista todos los cursos que puedo ver en Classroom" - "Envía una invitación a un estudiante para este curso" - "Actualiza la configuración de periodos de calificación del curso" ## Before you install - Requiere el binario `gws` y haber leído ../gws-shared/SKILL.md para autenticación, flags globales y reglas de seguridad. ## Files - SKILL.md — 7 KB ## SKILL.md Reproduced verbatim from googleworkspace/cli under Apache-2.0. This section is the upstream document and is in English. # classroom (v1) > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. ```bash gws classroom [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](https://developers.google.com/workspace/classroom/grading-periods/manage-grading-periods#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: ```bash # Browse resources and methods gws classroom --help # Inspect a method's required params, types, and defaults gws schema classroom.. ``` Use `gws schema` output to build your `--params` and `--json` flags. --- Skills Agentes — https://skillsagentes.com/skills/googleworkspace/cli/gws-classroom