Classroom-Dienst

Kurse und Teilnehmerlisten verwalten.

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

Dies ist ein erweiterter Dienst, der vor der Verwendung aktiviert werden muss. Folgen Sie der Kurzanleitung, um eine detaillierte Anleitung für den Einstieg zu erhalten.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur 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

Auf GitHub ansehen

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