课堂服务

借助 Google 课堂服务，您可以在 Google Apps 脚本中使用 Google Classroom API。借助此 API，管理员、教师和学生可以查看和管理课程及课程表。

这是一项高级服务，必须先启用才能使用。请按照快速入门指南中的分步说明开始操作。

参考

如需详细了解此服务，请参阅 Classroom API 的参考文档。与 Apps 脚本中的所有高级服务一样，Classroom 服务使用的对象、方法和参数均与公共 API 相同。如需了解详情，请参阅方法签名的确定方式。

如需报告问题并寻求其他支持，请参阅 Google 课堂支持指南。

示例代码

以下示例代码使用 API 的版本 1。

列出课程

此示例列出了用户有权访问的前 10 门课程。

advanced/classroom.gs

在 GitHub 上查看

/**
 * Lists 10 course names and IDs.
 */
function listCourses() {
  /**
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10,
    // Use other query parameters here if needed.
  };
  try {
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log("No courses found.");
      return;
    }
    // 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);
  }
}