Classroom Service

The Classroom service allows you to use the Google Classroom API in Apps Script. This API gives admins, teachers, and students the ability to view and manage their courses and rosters.


For detailed information on this service, see the reference documentation for the Google Classroom API. Like all advanced services in Apps Script, the Classroom service uses the same objects, methods, and parameters as the public API. For more information, see How method signatures are determined.

To report issues and find other support, see the Classroom support guide.

Sample code

The sample code below uses version 1 of the API.

List courses

This sample lists the first ten courses the user has access to.

 * Lists 10 course names and IDs.
function listCourses() {
   * @see
  const optionalArgs = {
    pageSize: 10
    // Use other query parameters here if needed.
  try {
    const response = Classroom.Courses.list(optionalArgs);
    const courses =;
    if (!courses || courses.length === 0) {
      console.log('No courses found.');
    // Print the course names and IDs of the available courses.
    for (const course in courses) {
      console.log('%s (%s)', courses[course].name, courses[course].id);
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    console.log('Failed with error %s', err.message);