Classroom 服務

您可以在 Apps Script 中使用 Classroom 服務的 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);
  }
}