google-classroom

name	google-classroom
description	Google Classroom — read and write courses, coursework, materials, and student submissions via the Google Classroom API for K-12 workflows.
metadata	{"openclaw":{"requires":{"env":["GOOGLE_CLIENT_ID","GOOGLE_CLIENT_SECRET","GOOGLE_REFRESH_TOKEN"]}},"primaryEnv":"GOOGLE_CLIENT_ID"}

Google Classroom

What it is

Google Classroom is Google's free LMS integrated into Google Workspace for Education, widely adopted in K-12 for assignment distribution, submission collection, grading, and class communication. It is accessed via the Google Classroom REST API and Google Drive API for attached files.

When to use this skill

• Fetching classwork titles, descriptions, due dates, and attached materials for tutoring context
• Retrieving student submission documents (linked Google Docs) for writing feedback
• Publishing teacher-created materials or assignments to a class topic
• Reading teacher comments and prior feedback to inform writing portfolio analysis
• Looking up course roster and topic structure for lesson-planning alignment

Credentials

This skill authenticates using env vars declared in the frontmatter metadata and provided via ~/.openclaw/.env (see .env.example at the segment root). Required variables:

• GOOGLE_CLIENT_ID - OAuth2 client ID from the Google Cloud project
• GOOGLE_CLIENT_SECRET - OAuth2 client secret
• GOOGLE_REFRESH_TOKEN - long-lived refresh token obtained via the OAuth2 authorization flow

Key operations

• GET /v1/courses — list active courses for the authenticated teacher or student
• GET /v1/courses/{id}/courseWork — retrieve all assignments and materials with due dates
• GET /v1/courses/{id}/courseWork/{cwId}/studentSubmissions — read student submission status and attached file IDs
• POST /v1/courses/{id}/courseWorkMaterials — publish a new material item to a topic
• PATCH /v1/courses/{id}/courseWork/{cwId}/studentSubmissions/{sid} — return a grade or drafted feedback
• GET /v1/userProfiles/{id} — look up name, email, and role for identity resolution

Notes

• The Classroom API requires appropriate OAuth2 scopes; use the least-privileged scope for each operation.
• Google Drive API is needed separately to read or write the content of attached Docs/Slides files.
• Tokens expire after 1 hour; always use the refresh token flow rather than prompting for re-authorization.
• Student submission data is FERPA-protected; do not cache submission content outside the sandbox workspace.