Stay organized with collections
Save and categorize content based on your preferences.
This page contains release notes for the Classroom API. Subscribe to
the announcement list to get email updates.
13 November 2023: Developer Preview: Rubrics CRUD
Rubrics CRUD is available as part of the Google Workspace Developer Preview
Program, which grants early access to certain features. This feature allows
developers to manage Classroom rubrics on behalf of teachers. See the
roadmap to learn more about participating in preview features.
26 June 2023: Non-breaking error code change for Invited Users
The following endpoints now return a 404 error for requests from Invited Users
(a teacher or student that has been invited to a course but has not yet
accepted). Previously these endpoints returned a 403:
courses.courseWork.create
courses.courseWork.delete
courses.courseWork.get
courses.courseWork.patch
courses.courseWorkMaterials.create
courses.courseWorkMaterials.delete
courses.courseWorkMaterials.get
courses.courseWorkMaterials.patch
courses.announcements.create
courses.announcements.delete
courses.announcements.get
courses.announcements.patch
The following related endpoints are unaffected:
courses.courseWork.list
courses.courseWork.modifyAssignees
courses.courseWorkMaterials.list
courses.announcements.list
courses.announcements.modifyAssignees
8 August 2022: Grade category and gradebook settings
Set share tag attributes
for course ID and material type when sharing content to Classroom.
2 April 2019: Topics in Classrooom
Retrieve,
create,
edit,
and delete
Topics in Classroom - now you can organize and retrieve Classwork items in Classroom through the API.
7 August 2018: Push notifications for course work and student submissions
Get real-time notifications of changes to course work and student submissions - now you can listen for new assignments being posted, students turning in their submissions, teachers grading submissions, and more
26 September 2017: Push notifications, announcements, and individualized posts
Get real-time notifications of roster changes - instead of polling Classroom API endpoints for changes, you can use Google Cloud Pub/Sub to get roster updates for a class or a domain
Create and update announcements - in addition to coursework, applications can now create and update announcements in the class stream
Create and update individualized posts - applications now have the option to post announcements or coursework to individual students, instead of the whole class
1 August 2017: Transfer course ownership and submission history
Update the primary owner of a course (ownerId) with admin credentials, or initiate an invitation for a teacher to become the course owner
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Release Notes\n\nThis page contains release notes for the Classroom API. Subscribe to\nthe [announcement list](https://groups.google.com/forum/#!forum/classroom-dev-announce) to get email updates.\n\n#### 13 November 2023: **Developer Preview: Rubrics CRUD**\n\n[Rubrics CRUD](/workspace/classroom/rubrics) is available as part of the [Google Workspace Developer Preview\nProgram](/workspace/preview), which grants early access to certain features. This feature allows\ndevelopers to manage Classroom [rubrics](https://support.google.com/edu/classroom/answer/9335069?co=GENIE.Platform%3DDesktop) on behalf of teachers. See the\n[roadmap](/workspace/classroom/reference/roadmap) to learn more about participating in preview features.\n\n#### 26 June 2023: **Non-breaking error code change for Invited Users**\n\nThe following endpoints now return a 404 error for requests from Invited Users\n(a teacher or student that has been [invited](/workspace/classroom/guides/manage-invitations) to a course but has not yet\naccepted). Previously these endpoints returned a 403:\n\n- `courses.courseWork.create`\n- `courses.courseWork.delete`\n- `courses.courseWork.get`\n- `courses.courseWork.patch`\n- `courses.courseWorkMaterials.create`\n- `courses.courseWorkMaterials.delete`\n- `courses.courseWorkMaterials.get`\n- `courses.courseWorkMaterials.patch`\n- `courses.announcements.create`\n- `courses.announcements.delete`\n- `courses.announcements.get`\n- `courses.announcements.patch`\n\nThe following related endpoints are unaffected:\n\n- `courses.courseWork.list`\n- `courses.courseWork.modifyAssignees`\n- `courses.courseWorkMaterials.list`\n- `courses.announcements.list`\n- `courses.announcements.modifyAssignees`\n\n#### 8 August 2022: **Grade category and gradebook settings**\n\nIt is now possible to retrieve the [grade category](/workspace/classroom/reference/rest/v1/GradeCategory) for coursework and\n[gradebook settings](/workspace/classroom/reference/rest/v1/courses#gradebooksettings) for courses using the API.\n\n#### 21 September 2020: **Classroom Materials**\n\nDevelopers can now read, write, and modify CourseWork Material items in Classroom:\n\n- [Create CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/create)\n- Retrieve [one](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/get) or [all CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/list)\n- [Update CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/patch)\n- [Modify attachments for CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/modifyAttachments)\n- [Delete CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/delete)\n\n#### 18 November 2019: **New Share Button URL Parameters**\n\n- Set [share tag attributes](https://developers.google.com/workspace/classroom/guides/sharebutton#share_tag_attributes) for course ID and material type when sharing content to Classroom.\n\n#### 2 April 2019: **Topics in Classrooom**\n\n- [Retrieve](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/list), [create](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/create), [edit](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/patch), and [delete](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/delete) Topics in Classroom - now you can organize and retrieve Classwork items in Classroom through the API.\n\n#### 7 August 2018: **Push notifications for course work and student submissions**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of changes to course work and student submissions - now you can listen for new assignments being posted, students turning in their submissions, teachers grading submissions, and more\n\n#### 26 September 2017: **Push notifications, announcements, and individualized posts**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of roster changes - instead of polling Classroom API endpoints for changes, you can use [Google Cloud Pub/Sub](https://cloud.google.com/pubsub/) to get roster updates for a class or a domain\n- Create and update [announcements](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.announcements) - in addition to coursework, applications can now create and update announcements in the class stream\n- Create and update [individualized posts](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) - applications now have the option to post announcements or coursework to individual students, instead of the whole class\n\n#### 1 August 2017: **Transfer course ownership and submission history**\n\n- [Update](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) the primary owner of a course (ownerId) with admin credentials, or initiate an [invitation](https://developers.google.com/workspace/classroom/reference/rest/v1/invitations#courserole) for a teacher to become the course owner\n- Access [submission history](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions) for a student submission\n\n#### 19 June 2017: **Schedule coursework, calendar, and verified teachers**\n\nUpdates to the Classroom API\n\n- [Schedule coursework](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) to post at a later date/time by setting the scheduledTime field of coursework\n- Access the [calendarId](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) of a course\n- Identify if a given user is a [verified teacher](https://developers.google.com/workspace/classroom/reference/rest/v1/userProfiles)\n\n#### 11 January 2017: **Coursework updates**\n\nUpdates to the [coursework](https://developers.google.com/workspace/classroom/guides/manage-coursework) endpoints lets applications:\n\n- Create and update questions\n- Modify and delete coursework\n- Add Drive items and YouTube videos to coursework and student submissions\n\n#### 17 August 2016: **Guardians in the Classroom API**\n\nGoogle Classroom generates email summaries of student activities for guardians. The Classroom API has support for [guardians](https://developers.google.com/workspace/classroom/guides/manage-guardians). Developers can\n\n- Invite individuals to become guardians\n- Retrieve a student's invited and active guardians\n- Manage active guardians\n\n- G Suite for Education admins should confirm their\n [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings)\n are correct.\n\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 18 May 2016: **Coursework added to the Classroom API**\n\nThe Classroom API now includes coursework - the assignments, questions,\nstudent responses, and grades. See the [Coursework guide](/workspace/classroom/guides/manage-coursework)\nto get started.\n\n#### 08 August 2015: **Classroom API now generally available**\n\nThe Classroom API is now available to all developers and G Suite for\nEducation domains. You no longer need to request access to begin using the API.\n\n- G Suite for Education admins should confirm their [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings) are correct.\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 29 June 2015: **Classroom API now available developer preview**\n\nThe Classroom API is now available for developer preview. You can sign up now\nfor early [access and test accounts](/workspace/classroom/access).\n\n- ~~G Suite for Education admins who want to give users in their domain early\n access to the API can\n [sign up for the domains whitelist](//support.google.com/code/contact/classroom_api_admin_preview).~~\n- ~~Developers can\n [apply for early access](https://docs.google.com/a/google.com/forms/d/1hY4Lk3imYBSOanQHZSqw1AYt9AswVGiltV-Jp7_5QpI/viewform)\n to code with the API.~~\n\nFor the full announcement, see the\n[Google for Education blog](//googleforeducation.blogspot.com/2015/06/new-ways-to-integrate-with-Google-Classroom.html)."]]
