---
name: gog-classroom
description: "Google Classroom via the gog CLI: list/read courses, coursework, announcements, materials, rosters, and submissions; create coursework/announcements; manage students/teachers; and grade/return submissions. Use for Classroom automation with JSON output."
---

# gog classroom

Classroom reads and writes with parseable output. Pick the account on every call
with `--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com classroom courses list --json --wrap-untrusted
gog --account you@example.com classroom courses get <courseId> --json
gog --account you@example.com classroom coursework list <courseId> --json --wrap-untrusted
gog --account you@example.com classroom announcements list <courseId> --json --wrap-untrusted
gog --account you@example.com classroom roster <courseId> --json
gog --account you@example.com classroom submissions list <courseId> <courseWorkId> --json
```

## Writes

```bash
gog --account you@example.com classroom courses create --name "Temp - course" --json
gog --account you@example.com classroom coursework create <courseId> --title "Homework 1"
gog --account you@example.com classroom announcements create <courseId> --text "..."
gog --account you@example.com classroom students add <courseId> --email student@school.edu
gog --account you@example.com classroom submissions grade <courseId> <courseWorkId> <submissionId> --grade 95
gog --account you@example.com classroom submissions return <courseId> <courseWorkId> <submissionId>
gog --account you@example.com classroom courses delete <courseId> --force
```

## Safety

- `delete`, `archive`, `students remove`, `teachers remove` affect real roster
  state — confirm ids; deletes need `--force`.
- `grade`/`return` post to students' gradebooks — verify before sending.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

`gog classroom --help` · `gog classroom <cmd> --help` · `gog schema classroom <cmd> --json`
Reference: <https://gogcli.sh/>
