Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

Übersicht

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die Classroom API bietet eine RESTful-Oberfläche, über die Sie Kurse und Teilnehmerlisten in Google Classroom verwalten können. Darüber hinaus können Entwickler und Rechteinhaber über die Schaltfläche zum Teilen in Classroom ihre Inhalte mit Classroom teilen.

Wer kann die API verwenden?

G Suite for Education-Domainadministratoren können mit der API programmatisch Kurse im Namen von Lehrkräften bereitstellen, Schüler-/Studenteninformationssysteme mit Classroom synchronisieren und grundlegende Einblicke in die Kurse in ihren Domains erhalten.

Anwendungsentwickler können die Classroom API verwenden, um ihre Apps in Classroom zu integrieren. Diese Anwendungen benötigen OAuth 2.0, um die Berechtigung zum Aufrufen von Klassen und Teilnehmerlisten von Lehrkräften anzufordern. Administratoren können einschränken, ob Lehrkräfte oder Schüler/Studenten in ihrer Domain Apps den Zugriff auf ihre Google Classroom-Daten erlauben dürfen.

Websiteinhaber und Inhaltsentwickler können die Schaltfläche zum Teilen in Classroom verwenden, damit Schüler, Studenten und Lehrkräfte Inhalte mit Classroom teilen können.

Alle API- und Classroom-Einbindungsschaltflächen müssen den Branding-Richtlinien für Classroom entsprechen.

API-Übersicht

Die Classroom API besteht aus mehreren Entitätstypen, die Kursen, Lehrkräften und Schülern oder Studenten in der Classroom-Oberfläche entsprechen. Einige dieser Entitäten haben neben den in Classroom vorhandenen Attributen noch weitere Attribute, die für die API spezifisch sind. Die primären Entitätstypen sind:

Ausführliche Informationen zu den Ressourcen und Methoden der API finden Sie in der Referenz zur Classroom API.

Kursmetadaten und -aliasse

Kurse stellen eine Klasse dar, z. B. "M. Smiths 4. Mathematik und die ihnen zugewiesenen Lehrkräfte, die Teilnehmerliste der Schüler und die Metadaten. Jeder Kurs wird durch eine eindeutige ID identifiziert, die vom Server zugewiesen wird. Die Kursressource enthält alle Metadaten zum Kurs, z. B. Name, Beschreibung, Ort und Zeit. Teilnehmerlisten werden über die Ressourcen Student, Teacher und Invitation und ihre Methoden verwaltet.

Aliasse sind alternative Kennzeichnungen für eine Klasse, die einem Kurs zugeordnet und anstelle der eindeutigen ID verwendet werden können. Jeder Alias befindet sich in einem Namespace, der beschränkt, wer ihn erstellen und aufrufen kann. Es werden zwei Namespaces unterstützt:

  • Domain: Der Domain-Namespace eignet sich zum Erstellen von Aliassen, auf die alle Nutzer Zugriff benötigen, die sich jedoch nicht auf ein bestimmtes Programm beziehen. Alternative Einträge für einen Kurs wie MATH 127 und COMSCI 127 sollten beispielsweise im Domain-Namespace erstellt werden. Aliasse im Domain-Namespace können nur von Domainadministratoren erstellt werden, sind aber für alle Nutzer in einer Domain sichtbar.
  • Entwicklerprojekt: Der Namespace des Entwicklerprojekts ist nützlich, um für eine Anwendung spezifische Aliasse zu verwalten. Beispielsweise kann eine Anwendung, die alternative Kennzeichnungen für Kurse verwendet, Aliasse erstellen, um ihre Kennung Classroom-Kursen zuzuordnen. Aliasse, die in diesem Namespace erstellt wurden, sind an eine bestimmte Google API Console gebunden. Jeder Nutzer einer Anwendung kann Aliasse im Namespace für dieses Entwicklerprojekt erstellen und aufrufen.

Weitere Informationen zum Verwalten von Kursmetadaten und Aliassen finden Sie unter Kurse verwalten.

Teilnehmerlisten und Nutzer

Schüler/Studenten und Lehrkräfte sind spezifische Verknüpfungen zwischen einem Nutzerprofil und einem Kurs, die die Rolle dieses Nutzers im Kurs darstellen. Die Bezeichnungen „Student“ und „Lehrkraft“ sind nicht global: Ein Nutzer kann als Lehrkraft für einen Kurs und als Schüler/Student in einem anderen Kurs zugewiesen werden. Die Bezeichnung „Student“ oder „Lehrer“ stellt eine Reihe von Berechtigungen für einen bestimmten Nutzer in einem bestimmten Kurs dar.

Kursteilnehmer
Eine Schülerressource stellt einen Nutzer dar, der als Schüler in einem bestimmten Kurs eingeschrieben ist. Schüler/Studenten können sich die Kursdetails und die Lehrkräfte für diesen Kurs ansehen.
Lehrer
Eine Lehrkraft ist ein Nutzer, der einen bestimmten Kurs unterrichtet. Lehrkräfte dürfen die Kursdetails ansehen und ändern, Lehrkräfte und Schüler/Studenten ansehen sowie zusätzliche Lehrkräfte und Schüler oder Studenten verwalten.

Über Einladungen und die zugehörigen Methoden können Sie bequem Kurse und Teilnehmer hinzufügen. Wenn Sie Einladungen erstellen, können Nutzer auswählen, ob sie an einem Kurs teilnehmen möchten. Sie müssen diese Ressourcen nicht selbst über die Ressourcen für Lehrkräfte und Schüler oder Studenten hinzufügen.

UserProfiles stellen eine Zuordnung zu einem Domainprofil eines Nutzers dar, der durch die eindeutige ID oder E-Mail-Adresse des Nutzers identifiziert wird, die vom Google Admin SDK zurückgegeben wird. Der aktuelle Nutzer kann sich auch mithilfe des "me"-Kurzbefehls auf seine eigene ID beziehen.

Weitere Informationen zum Verwalten von Teilnehmerlisten finden Sie unter Lehrkräfte und Schüler/Studenten verwalten.

Arbeiten und Arbeiten von Schülern oder Studenten

Ein Element Kurs ist eine einzelne Aufgabe, die einer Gruppe von Teilnehmern eines Kurses zugewiesen ist. Er enthält Details wie die Beschreibung, das Fälligkeitsdatum und Materialien sowie Metadaten wie den Erstellungszeitpunkt. Zu den Materialien gehören ein Titel, ein Thumbnail, eine URL und eine Kennung, die mit den entsprechenden APIs wie Drive oder YouTube verwendet werden kann.

In Kurs-Work-Elementen wird eine der folgenden Arten von Aufgaben beschrieben:

  • Eine Aufgabe, die Schüler oder Studenten mit Arbeitsblättern oder anderen Anhängen abschließen
  • Eine Kurzantwort- oder Multiple-Choice-Frage.

Die Aufgaben von Schülern/Studenten eines Kurses werden durch ein StudentSubmission-Objekt repräsentiert. Sie besteht aus einer Antwort und zusätzlichen Metadaten wie einem Status und einer zugewiesenen Note.

Der Inhalt eines StudentSubmission-Elements hängt vom Typ des entsprechenden Kurs-Elements ab:

  • Die Arbeitsblätter und Anhänge, die für eine Aufgabe eingereicht wurden, einschließlich Titel, Thumbnail und URL sowie Kennzeichnungen, die mit den entsprechenden APIs wie Drive oder YouTube verwendet werden können.
  • Die Antwort auf eine Kurzantwort- oder eine Multiple-Choice-Frage.

Weitere Informationen zum Verwalten von Kursaufgaben und Aufgaben finden Sie unter Kursaufgaben verwalten.

Erste Schritte

Probieren Sie eine der Kurzanleitungen aus, um Ihre Umgebung einzurichten und sofort mit der API zu beginnen:

Sie können sich auch die API-Referenz ansehen.