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 für die Google Classroom API. Wie alle erweiterten Dienste in Apps Script verwendet auch der Classroom-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter So werden Methodensignaturen ermittelt.

Im Supportleitfaden für Classroom können Sie Probleme melden und weitere Unterstützung erhalten.

Beispielcode

Im folgenden Beispielcode wird Version 1 der API verwendet.

Kurse auflisten

In diesem Beispiel werden die ersten zehn Kurse aufgelistet, 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);
  }
}