Usługa Classroom

Zarządzanie kursami i listami uczniów.

Usługa Classroom umożliwia korzystanie z interfejsu Google Classroom API w Google Apps Script. Ten interfejs API daje administratorom, nauczycielom i uczniom możliwość wyświetlania kursów i list uczniów oraz zarządzania nimi.

Jest to usługa zaawansowana, którą należy włączyć przed użyciem. Szczegółowe instrukcje znajdziesz w przewodniku Szybki start.

Dokumentacja

Szczegółowe informacje o tej usłudze znajdziesz w dokumentacji interfejsu Classroom API. Podobnie jak wszystkie usługi zaawansowane w Apps Script, usługa Classroom używa tych samych obiektów, metod i parametrów co publiczny interfejs API. Więcej informacji znajdziesz w artykule Jak określa się sygnatury metod.

Aby zgłosić problemy i uzyskać pomoc, zapoznaj się z przewodnikiem pomocy dotyczącym Classroom.

Przykładowy kod

Poniższy przykładowy kod korzysta z wersji 1 interfejsu API.

Wyświetlanie listy kursów

Ten przykład wyświetla pierwsze 10 kursów, do których użytkownik ma dostęp.

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