Classroom 服務

Classroom 服務可讓您在 Apps Script 中使用 Google Classroom API。管理員、老師和學生都能透過這個 API 查看及管理自己的課程和學生名單。

參考資料

如要進一步瞭解這項服務，請參閱 Google Classroom API 的參考說明文件。如同 Apps Script 的所有進階服務，Classroom 服務會使用與公用 API 相同的物件、方法和參數。詳情請參閱「如何判定方法簽章」一文。

如要回報問題及尋找其他支援，請參閱 Classroom 支援指南。

程式碼範例

下方程式碼範例使用第 1 版的 API。

列出課程

這個範例列出了使用者可存取的前十個課程。

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);
  }
}