Classroom 服務

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

參考資料

如需這項服務的詳細資訊,請參閱 Google Classroom API 的參考說明文件。與 Apps Script 中的所有進階服務一樣,Classroom 服務會使用與公開 API 相同的物件、方法和參數。詳情請參閱「如何決定方法簽章」。

如要回報問題或尋求其他支援,請參閱 Classroom 支援指南

程式碼範例

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

列出課程

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

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