课堂服务

管理课程和学生名单。

借助 Classroom 服务，您可以在 Google Apps 脚本中使用 Google Classroom API。通过此 API，管理员、教师和学生可以查看和管理自己的课程和学生名单。

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

参考

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

如需报告问题和查找其他支持，请参阅 Classroom 支持指南。

示例代码

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

列出课程

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

advanced/classroom.gs
/**
 * 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);
  }
}