Classroom-Dienst

Mit dem Classroom-Dienst können Sie die Google Classroom API in Apps Script verwenden. Mit dieser API können Administratoren, Lehrkräfte und Schüler/Studenten ihre Kurse und Teilnehmerlisten ansehen und verwalten.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur Google Classroom API. Wie alle erweiterten Dienste in Apps Script verwendet der Classroom-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Methodensignaturen ermitteln.

Informationen zum Melden von Problemen und zu Supportoptionen finden Sie im Classroom-Supportleitfaden.

Beispielcode

Im folgenden Beispielcode wird Version 1 der API verwendet.

Kurse auflisten

In diesem Beispiel sind die ersten zehn Kurse aufgeführt, auf die der Nutzer Zugriff hat.

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