google classroom api get assignments

How to use Google Classroom APIs to retrieve and update classwork

Francislainy Campos

HMH Engineering

We have been working with the Google Classroom APIs and would like to share a bit of our findings on how to use them.

Let’s assume your Google Cloud console is already set up and the Java quick start project as well. Any questions on how to do this, please follow along with our previous tutorial .

Once you’re all set let’s start retrieving the list of courses for a user.

https://developers.google.com/classroom/reference/rest/v1/courses/list

It will respond with a list of courses and a pageToken for the next page so that when it’s not null we know there are more courses to be retrieved. This token would then be used on the request for the next page. It’s an optional parameter and when it’s not there, the api will return the first page with courses limited by the page size amount.

You can experiment with the api under the developers page.

Once we have a list of courses, we can create assignments for them, which we’ll call course work. This will be possible only for active courses.

The below would be a snippet for this based on https://developers.google.com/classroom/reference/rest/v1/courses.courseWork/create :

Here we’re looping through the list of courses and creating assignments for the active ones. We could also be retrieving the course based on its id or any other unique identifier we may want to use for this task.

We need to set the date and time for when the assignment is due and for this we create the respective some date and time objects (not to confuse with the java.util.Date class, which is used for scheduling when the assignment will be available).

Speaking of which, scheduling a time is only possible for assignments that are in draft mode, which is the default option. If they are already published, this option would become redundante and the Classroom API logs an error.

We also have the option to create the assignment for the whole class setAssigneeMode(ALL_STUDENTS) or for individual students .setAssigneeMode(“INDIVIDUAL_STUDENTS”) , which in this case requires as to populate a IndividualStudentsOptions object.

Once we have a courseWork object such as the one below , we can also do updates to the assignments that we created using the patch endpoint.

https://developers.google.com/classroom/reference/rest/v1/courses.courseWork/patch

We need to be attentive to the object updateMask where we provide the string representation for each field we want to update, in our case, title and description.

We can also loop through the list of courseWorks set to a course and retrieve one that we like.

Written by Francislainy Campos

One who likes biking, Pokémon and chocolate.

More from Francislainy Campos and HMH Engineering

Integrating Cucumber into a Spring Boot Project: A Step-by-Step Guide

With cucumber 7+, junit5, maven, restassured, postgres, jpa and jdbc template..

How to write and validate Pact contracts using JUnit5 and REST Assured

What i’ve learned so far.

How to use Selenium to inject Okta authentication tokens into Rest Assured

(from pom file up to docker and jenkins ci).

How to get Oauth access token and retrieve data from Google APIs using Postman

We have been working with the google classroom apis and would like to share a bit of our findings on how to trigger these apis using the…, recommended from medium.

Contract Testing using Pact

We have transitioned from a time when deployments occurred once every few days to a scenario where deployments take place every few seconds….

Crafted Codes

Mobile App Circular

The Syntax Chronicles: Implementing Google Sheets API in your Android app

A guide to kotlin, moshi and retrofit.

General Coding Knowledge

Coding & Development

Stories to Help You Grow as a Software Developer

ChatGPT prompts

Adam Karmiński

Avoid the Sea of Mold — a scalable Jira setup for managing your Product and Teams projects

If you struggle with managing hundreds of product-related issues in your jira projects, this guide will change your life forever, trust me..

Robot Framework

Mobile App Testing -A War Story

Billionaires_Success_Club

Make Money with YouTube Automation

Youtube has become one of the most popular platforms for content creators to showcase their talent, share knowledge, and connect with a….

Artturi Jalli

I Built an App in 6 Hours that Makes $1,500/Mo

Copy my strategy.

Text to speech

Navigation Menu

Search code, repositories, users, issues, pull requests..., provide feedback.

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly.

To see all available qualifiers, see our documentation .

google-classroom-api

Google Classroom is a free blended learning platform developed by Google for educational institutions that aims to simplify creating, distributing, and grading assignments. The primary purpose of Google Classroom is to streamline the process of sharing files between teachers and students.

Other resources

• Read the API documentation at https://developers.google.com/classroom
• Access the application at https://classroom.google.com

Here are 23 public repositories matching this topic...

Kippnorcal / google_classroom.

Google Classroom Data Pipeline

• Updated Apr 5, 2021

sayanmedya / Nomi

Discord Bot to automatically notify users before events(classes/announcements/assignments), search events, add/remove/modify events from Google Calendar and Google Classroom

• Updated Oct 28, 2021

ahzia / Bootcamp

Bootcamp.af - is a youtube based e-learning platform shortlisted as one of the top 50 semifinalists in Google Developer Student Club Solution Challange 2021.

• Updated Oct 15, 2021

maleeqB / Classroom-Client

Google Classroom Client Application

• Updated Mar 31, 2021

daaniiieel / homie

A simple program that synchronizes your Classroom and KRÉTA assignments to Todoist

• Updated Nov 7, 2021

Levminer / google-classroom-feed

A simple Node.js and Express app that collects everything from your Google Classroom courses

• Updated Nov 14, 2020

naghim / Classroom-Submission-Downloader

Downloads all student submissions from several Google Classroom assignments.

• Updated May 7, 2023

ralphg6 / teaching-tracker

The project was created to generate analyzes about student performance on Google Classroom using his API.

• Updated Nov 29, 2020

xxl4tomxu98 / student_submissions

A Python Flask based backend server to work with PostgreSql database using Psycopg2 and SqlAlchemy. A React.js based front rendering of query results.

• Updated Feb 16, 2021

lebrancconvas / MRQuest

Inspired From my friend project. (Gamification for Mixed Reality Class).

• Updated Jun 6, 2023

Thanitkul / cs50-final-project-classroom-manager-v1

Web application that helps to manage classes in google classroom on the teacher side.

• Updated Aug 11, 2023

sumitjangir123 / Thunder-Meet

Thunder Meet is a web application used to organize institutes with the help of this application you can register your institute and all classes and Google meeting links will be generated automatically and with the help of Google Classroom API will be organized , It informs students for classes and many important features are also added. A Chrome…

• Updated May 10, 2021

josephJJ1020 / Google-Classroom-Deadline-Notifications-using-Classroom-API-and-win10toast-

Script that notifies user's due activities on startup - made with Google Classroom API and Win10Toast

• Updated Aug 24, 2021

rubhiauliatirta / mister-class

Web application for reuse multiple assignment in your google classroom. https://cbr.rubhiauliatirta.com

• Updated Jun 5, 2021

Sekers / GoogleWorkspace

PowerShell module for the Google Workspace API

• Updated Apr 18, 2024

ameybhavsar24 / ww-classroom-bot

Whatsapp Web bot with Classroom API to fetch courses and classwork information directly via Whatsapp messages.

• Updated Jun 20, 2021

et0and / ocular

A basic Python script for monitoring Google Classroom assignment submissions 👀

• Updated Apr 24, 2023

kurtnettle / 4903

a multi-featured discord bot that aims to keep you updated with university updates, Google classroom notifications, cp contest reminders and much more!

• Updated Jun 16, 2022

assignmenttracker / assignment-tracker

• Updated Dec 4, 2020

HimanshuChittora23908 / acadhere_testing

• Updated Jan 20, 2022

Created by Google

Related Topics

How Apps Can Sync Assignments and Grades with Google Classroom

Syncing assignments and grades is one of the most valuable aspects of integrating with an LMS. Through Google Classroom’s API, developers can integrate applications with the LMS and enable several features to enhance interoperability.

Jordan Clark

Read more posts by this author.

Syncing assignments and grades is one of the most valuable aspects of integrating with a learning management system (LMS). This logic applies to Google Classroom too. Through its API, developers can integrate their application with Google Classroom and enable several features to enhance interoperability between the LMS and their application, including assignment and grade syncing. We'll cover how assignment and grade syncing in Google Classroom works and why educational developers should implement these features in their products.

What does it look like to sync assignments and grades?

The Google Classroom API allows developers to create an assignment in Google Classroom from a third-party application. This assignment can contain content or link to outside resources. The Classroom API is unique in that it allows for personalized assignments. This means that teachers can assign homework or other content to specific students, rather than to everyone in a class. Each assignment can also be given a maximum grade value that signifies how much the coursework is worth.

Additionally, the API allows students to make submissions to their assigned coursework. The submission can be in the form of a short answer, multiple choice answer, or attachment. Once submitted, a grade may also be passed back to Google Classroom for the specific assignment and recorded in the teacher's gradebook.

How to sync assignments and grades

In order to start working with the Google Classroom API , you'll have to create a Google account and request access to the Google Cloud Platform. From there, you'll be able to generate API keys that you'll use in your application to authenticate users and communicate with Google Classroom.

In order to allow Google Classroom users to log into your application and create assignments through your application, you'll have to request permission to use specific scopes. These scopes determine what information you can retrieve from a user and what actions (such as creating coursework) you can do on their behalf. Some scopes are deemed sensitive and require manual verification from Google before you can use them in your application.

Once you receive approval from Google for your scopes, you can develop your app using the Google Classroom API . The API documentation provides instructions how to manage coursework resources, such as assignments, submissions, and grades. The developer docs also provide information on the REST resources that are available by calling requests to specific endpoints in Google Classroom. These endpoints are what allow you to perform actions on behalf of the user, such as syncing coursework and grades between your application and the user's Google Classroom account.

The benefits of syncing assignments and grades

There are several benefits to integrating your content so that end users can sync assignments and grades from Google Classroom. When you enable grade passback, the application doesn't have to maintain a full database of grades for the teacher to view. Instead, all of the grade data can be transmitted back to the LMS.

Since you're relying on the LMS to host the assignments and gradebook, you won't have to retrain teachers on how to access them. With the API, assignments and grades sent from your platform will appear as they normally would inside of Classroom.

Perhaps the biggest benefit of enabling assignment and grade syncing is that schools are actively looking for this type of functionality from their content providers. Google Classroom continues to grow and schools want to see content that integrates with its API. Making sure that your platform can integrate with Classroom can keep you ahead of the curve.

Read More on Google Classroom

Here are other articles we’ve written on Google Classroom ] to help you on your integration journey:

• How Google Classroom Integrations Differ from other LMSs
• How to Whitelist an Application Google
• How to Implement SSO for Google Classroom
• Google Classroom vs. Microsoft Teams: A Side-by-Side Integration Comparison
• The Challenges of Integrating with Google Classroom?

Want to Learn More about Edlink?

If you're looking for a partner who can help guide you through developing LMS integrations (like these ), then let’s introduce ourselves. We’re Edlink!

• Introducing Edlink
• Our Mission at Edlink
• What is the Edlink Unified API?

Google Classroom

Google Classroom helps educators create engaging learning experiences they can personalize, manage, and measure.

Google Classroom API Integrations

Build and run workflows using the google classroom api. use 1000s of source-available triggers and actions across 2,000+ apps. or write custom code to integrate any app or api in seconds..

The Google Classroom API lets you tap into the educational space by managing courses, assignments, and student interactions programmatically. With this API, you can automate course creation, roster management, and content distribution, effectively bridging the gap between various educational tools and platforms. Leveraging Pipedream's serverless execution environment, you can build powerful workflows that respond to events in Classroom, sync data across platforms, and streamline the educational process for teachers and students alike.

Choose an API to Connect with Google Classroom API #

1 - 24 of 2,000+ apps by most popular.

Example Use Cases #

Automated Course Management : Create workflows that automatically set up new courses at the beginning of a term, including setting up course materials in Google Drive and scheduling calendar events for class times. When a new term starts, this automation can save educators hours of setup time.

Assignment Distribution and Collection : As soon as assignments are created in Google Classroom, trigger a workflow on Pipedream that generates a template in Google Docs, shares it with the students, and then collects submitted assignments for review. This can vastly simplify the distribution and collection process for instructors.

Grading and Feedback Integration : When grades are posted in Google Classroom, use Pipedream to trigger notifications to students via email or a messaging app like Slack. Additionally, integrate with a tool like Google Sheets to automatically update a master gradebook with the latest scores.

Popular Google Classroom Integrations #

Popular Google Classroom Triggers #

Emit new event when an assignment in a course is marked as done.

Emit new event when an announcement is created.

Emit new event when an assignment is added to a course.

Emit new event when an assignment's due date is created or updated'.

Popular Google Classroom Actions #

Retrieve information about an assignment. See the docs here

Retrieve a list of assignments for a course. See the documentation

Authentication #

Google Classroom uses OAuth authentication. When you connect your Google Classroom account, Pipedream will open a popup window where you can sign into Google Classroom and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Google Classroom API.

Pipedream requests the following authorization scopes when you connect your account:

• authorization GET https://accounts.google.com/o/oauth2/auth ? client_id= {{oauth.client_id}} & redirect_uri= {{oauth.redirect_uri}} & state= {{oauth.state}} & response_type= code & scope= {{oauth.space_separated_scopes}} & prompt= consent & access_type= offline
• accessToken POST https://oauth2.googleapis.com/token content-type: application/x-www-form-urlencoded accept: application/json client_id= {{oauth.client_id}} & client_secret= {{oauth.client_secret}} & redirect_uri= {{oauth.redirect_uri}} & grant_type= authorization_code & code= {{oauth.code}}
• refreshToken POST https://oauth2.googleapis.com/token content-type: application/x-www-form-urlencoded accept: application/json client_id= {{oauth.client_id}} & client_secret= {{oauth.client_secret}} & grant_type= refresh_token & refresh_token= {{oauth.refresh_token}}

Additional details for assignments. More...

Detailed Description

Additional details for assignments.

Property Documentation

◆  etag.

The ETag of the item.

◆  StudentWorkFolder

Drive folder where attachments from student submissions are placed. This is only populated for course teachers and administrators.

• Google.Apis.Classroom.v1.cs

© 2020 Google - Privacy Policy - Terms and Conditions - About Google

• Help Center
• Privacy Policy
• Terms of Service
• Submit feedback
• Announcements
• Organize and communicate with your class
• Create assignments

Create an assignment

This article is for teachers.

When you create an assignment, you can post it immediately, save a draft, or schedule it to post at a later date. After students complete and turn in their work, you can grade and return it to the students.

Open all | Close all

Create & post assignments

When you create an assignment, you can:

• Select one or more classes

Select individual students

Add a grade category, add a grading period, change the point value, add a due date or time, add a topic, add attachments, add a rubric.

• Turn on originality reports

Go to classroom.google.com  and click Sign In.

Sign in with your Google Account. For example,  [email protected] or [email protected] .  Learn more .

• Enter the title and any instructions.

You can continue to edit and customize your assignment. Otherwise, if you’re ready, see below to post, schedule, or save your assignment .

Select additional classes

Assignments to multiple classes go to all students in those classes.

• Create an assignment (details above).

Unless you’re selecting multiple classes, you can select individual students. You can’t select more than 100 students at a time.

• Click a student's name to select them.

Use grade categories to organize assignments. With grade categories, you and your students can see the category an assignment belongs to, such as Homework or Essays . Teachers also see the categories on the Grades page.

For more information on grade categories, go to Add a grade category to posts or Set up grading .

To organize assignments and grades into your school or district’s grading structure, create grading periods, such as quarters or semesters.

• From the menu, select a grading period.

Tip: Before adding a grading period to an assignment, create a grading period for the class first. Learn how to create or edit grading periods .

You can change the point value of an assignment or make the assignment ungraded. By default, assignments are set at 100 points.

• Under Points , click the value.
• Enter a new point value or select Ungraded .

By default, an assignment has no due date. To set a due date:

• Click a date on the calendar.
• To create a topic, click Create topic and enter a topic name.
• Click a topic in the list to select it.

Note : You can only add one topic to an assignment.

Learn more about how to add topics to the Classwork page .

• Create an assignment.

• Important: Google Drive files can be edited by co-teachers and are view-only to students. To change these share options, you can stop, limit, or change sharing .

• To add YouTube videos, an admin must turn on this option. Learn about access settings for your Google Workspace for Education account .
• You can add interactive questions to YouTube video attachments. Learn how to add interactive questions to YouTube video attachments .

• Tip: When you attach a practice set to an assignment, you can't edit it.

• If you see a message that you don’t have permission to attach a file, click Copy . Classroom makes a copy of the file to attach to the assignment and saves it to the class Drive folder.
• Students can view file —All students can read the file, but not edit it.
• Students can edit file —All students share the same file and can make changes to it.

Note : This option is only available before you post an assignment.

Use an add-on

For instructions, go to Use add-ons in Classroom

For instructions, go to Create or reuse a rubric for an assignment .

For instructions, go to Turn on originality reports .

You can post an assignment immediately, or schedule it to post later. If you don’t want to post it yet, you can save it as a draft. To see scheduled and drafted assignments, click Classwork .

Post an assignment

• Follow the steps above to create an assignment.
• Click Assign to immediately post the assignment.

Schedule the assignment to post later

Scheduled assignments might be delayed up to 5 minutes after the post time.

• To schedule the same assignment across multiple classes, make sure to select all classes you want to include.
• When you enter a time, Classroom defaults to PM unless you specify AM.
• (Optional) Select a due date and topic for each class.
• (Optional) To replicate your selected time and date for the first class into all subsequent classes, click Copy settings to all .
• Click Schedule . The assignment will automatically post at the scheduled date and time.

After scheduling multiple assignments at once, you can still edit assignments later by clicking into each class and changing them individually.

Save an assignment as a draft

• Follow the steps above to create an assignment

You can open and edit draft assignments on the Classwork page.

Manage assignments

Edits affect individual classes. For multi-class assignments, make edits in each class.

Note : If you change an assignment's name, the assignment's Drive folder name isn't updated. Go to Drive and rename the folder.

Edit a posted assignment

• Enter your changes and click Save .

Edit a scheduled assignment

• Enter your changes and click Schedule .

Edit a draft assignment

Changes are automatically saved.

• Assign it immediately (details above).
• Schedule it to post at a specific date and time (details above).
• Click a class.

You can only delete an assignment on the Classwork page.

If you delete an assignment, all grades and comments related to the assignment are deleted. However, any attachments or files created by you or the students are still available in Drive.

Related articles

• Create or reuse a rubric for an assignment
• Create a quiz assignment
• Create a question
• Use add-ons in Classroom
• Create, edit, delete, or share a practice set
• Learn about interactive questions for YouTube videos in Google Classroom

Was this helpful?

Need more help, try these next steps:.