Übersicht

Die Google Classroom API bietet eine Programmierschnittstelle für Softwareentwickler, Administratoren und Schulleitungen, um Google Classroom-Ressourcen zu verwalten. Sie können Software entwickeln, mit der Classroom-Kurse und deren Inhalte erstellt, abgerufen und geändert werden.

Einige typische Anwendungsfälle:

  • Kurse, Teilnehmerlisten und Erziehungsberechtigte verwalten
  • Aufgaben, Ankündigungen und Kursmaterialien hinzufügen
  • Noten zuweisen und Benotungseinstellungen ändern
  • Daten für die Analyse generieren
  • Inhalte oder Tools von externen Anbietern in Classroom auffindbar und zugänglich machen

Ist die Classroom API die richtige Lösung für mich?

Google bietet verschiedene Produkte, die Sie bei der Interaktion mit Classroom unterstützen. Im Folgenden finden Sie einige gängige Szenarien und Empfehlungen für Produkte, die Ihren Anforderungen am besten entsprechen könnten.

Google Classroom-Ressourcen ändern

Szenario Empfohlene Lösungen
Ich möchte regelmäßig eine große Anzahl von Kursen, Nutzern oder anderen Classroom-Ressourcen verwalten. Ich habe Erfahrung mit dem Schreiben von Code und der Verwaltung von Softwareinfrastrukturen. Anwendungen schreiben, die die Classroom API verwenden
Ich möchte gelegentlich eine kleine Menge an Classroom-Ressourcen verwalten. Ich kann kleine Codemengen mit wenig Aufwand schreiben. Classroom API mit Google Apps Script verwenden
Ich möchte gelegentlich Änderungen an einzelnen Classroom-Ressourcen vornehmen. Ich kann mit Terminalbefehlen umgehen. Google Apps Manager verwenden
Ich möchte viele Berichte mit Details zu Ereignissen in Classroom erhalten. Verwenden Sie den BigQuery Data Transfer Service.
Ich möchte die Aktivitäten meiner Nutzer untersuchen. Sie können Berichte in der Admin-Konsole generieren oder die Reports API verwenden.

In Google Classroom einbinden

Szenario Empfohlene Lösungen
Ich möchte, dass Lehrkräfte und Schüler/Studenten meine Inhalte in Classroom sehen und starten können. Classroom-Add-on erstellen
Ich möchte, dass Lehrkräfte auf meiner Website oder in meiner App auf eine Schaltfläche klicken, um meine Inhalte in Classroom einzubetten. Sie können ein Classroom-Add-on erstellen und Anhänge programmatisch erstellen.
Ich möchte, dass Lehrkräfte auf meiner Website oder in meiner App auf eine Schaltfläche klicken können, um eine Verknüpfung zu meinen Inhalten in Classroom herzustellen. Erstellen Sie Kursmaterialien mit der Classroom API oder fügen Sie die Schaltfläche Mit Classroom teilen ein.
Ich möchte, dass Classroom-Lehrkräfte Informationen aus meinem Schüler-/Studenteninformationssystem synchronisieren oder importieren können. Implementieren Sie OneRoster für SIS oder erstellen und greifen Sie mit der Classroom API auf Ressourcen zu.

Erste Schritte

Wir empfehlen neuen Entwicklern, vor Beginn eines neuen Projekts Folgendes zu tun:

Bevor Sie mit der Entwicklung beginnen, müssen Sie die erforderlichen Schritte abgeschlossen haben. Wählen Sie die zugehörigen Berechtigungen für die Classroom API aus, richten Sie Ihre Umgebung ein und senden Sie Anfragen. Folgen Sie dazu einer der folgenden Kurzanleitungen:

Mit dem Google APIs Explorer experimentieren

Wenn Sie das Aufrufen von Methoden für Live-Daten testen möchten, können Sie den Google APIs Explorer verwenden. Sie müssen keinen Code schreiben, um loszulegen. Beachten Sie jedoch, dass durch Aktionen, die Sie mit dem APIs Explorer ausführen, vorhandene Daten geändert werden können.

Eine Möglichkeit, die Methoden aufzurufen, besteht darin, die Methode courses.list() aufzurufen. Für diese Methode sind keine Anfrageparameter erforderlich. Sie können eine id aus der zurückgegebenen Liste von Kursen abrufen, die als Anfrageparameter für andere API-Aufrufe verwendet werden soll. Wenn Sie noch keine Kurse haben, können Sie mit der Methode courses.create() einen erstellen.

Weitere Informationen finden Sie auch in der Referenz zur Classroom API.