Classroom 服務

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

這項進階服務必須啟用才能使用。請按照快速入門導覽課程的逐步操作說明開始使用。

參考資料

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

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

程式碼範例

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

列出課程

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

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