November 2024 developer updates
Google for Education Developer Announcements
Below are this month's Google for Education developer news items. Please reach out to our support resources with any questions or concerns.
Announcements✅ See our Preview the Classroom API guide for information about upcoming features and instructions on accessing and using them.
The Grading Periods API endpoints are now generally available (GA) and integrated into the v1 Classroom API.
The endpoints allow developers to manage grading period settings within a course on behalf of teachers and administrators. With the GA launch, you no longer need to be part of the Developer Preview Program or specify the previewVersion parameter to use the Grading Periods API endpoints. You should remove any occurrences of previewVersion=`V1_20240401_PREVIEW` from the following endpoints:
courses.courseWork.create if you specified the gradingPeriodId in the request.
courses.courseWork.patch if you specified the gradingPeriodId in the request.
Reminders from last time:
The new checkUserEligibility endpoint is now available in developer preview.
Previously, developers could check whether users have access to certain Classroom features using multiple dedicated methods, such as checkAddOnCreationEligibility and checkGradingPeriodsSetupEligibility.
Going forward, the single checkUserEligibility method can be used to get the same information. This addition introduces a single pathway for developers to determine eligibility for many features. At launch, the new method will return eligibility for creating/modifying grading periods and add-on attachment creation. Support for additional features will be added over time. See the user eligibility guide for more details.
The current checkAddOnCreationEligibility and checkGradingPeriodsSetupEligibility methods are now marked as deprecated. You do not need to take action at this time if your application is currently using them. We expect these methods will be removed sometime in 2025, and will provide migration guidance once a removal date has been set. We encourage you to adopt checkUserEligibility proactively.
API support for rubrics launched to general availability in December 2024.
This new feature enables developers to create and manage Classroom rubrics on behalf of teachers at scale, and retrieve rubric-based grades on student submissions to support more holistic student performance insights.
As part of this change, API support for creating, updating, and deleting rubrics will only be possible for users with an Education Plus license. The aforementioned checkUserEligibility was expanded to enable developers to easily determine which users are able to take advantage of this functionality. The rubrics and user eligibility guides have been updated to reflect these changes. See the announcement for full details.
No recent changes.
Reminders from last time:
The add-ons requirements have been revised. We have made them less restrictive by changing several required items to recommendations. No action is required for already-published add-ons; these requirements will apply to all future add-on submissions.
Classroom API reference documentation
Please be advised of the following API changes this month:
The following methods are generally available:
courses.courseWork.create() supports gradingPeriodId in the request.
courses.courseWork.patch() supports gradingPeriodId in the request.
Reminders from last time:
The following methods are generally available:
The studentSubmission resource supports read-only draftRubricGrades and assignedRubricGrades fields.
The checkUserEligibility() endpoint supports a CREATE_RUBRIC enum.
Please be advised of the following documentation changes this month:
Clarification improvements in the guides for add-ons, user eligibility, OneRoster, courses, aliases, grading, the Classroom share button, coursework, invitations, and more.
Restructured API error and troubleshooting guides for searchability.
Reminders from last time:
We've redesigned our Classroom API guides. The newly reorganized site should be much easier to navigate and more accessible to developers and school leaders. We welcome your feedback and suggestions on the redesign (use the Send Feedback button or open the Page info on the side of the page and click the “Send feedback” bug icon).
Getting support