KursWork-Integration

Entwickler können die Google Classroom API verwenden, um mit Kursmaterialien in Google Classroom zu interagieren. Eine Anwendung, die die API auf diese Weise verwendet, wird als CourseWork-Integration bezeichnet.

Dieser Integrationspfad wird häufig verwendet, um Aufgaben mit Links zu Ressourcen außerhalb von Classroom zu erstellen und zu benoten. Im Vergleich zu den Freigabeschaltflächen in Classroom bietet es einen umfassenderen Zugriff auf die Verwaltung von Kursaufgaben.

Funktionsweise

Das Hauptmerkmal einer CourseWork-Integration ist das Erstellen und Verwalten von Aufgaben, Ankündigungen und Kursmaterialien mit der Classroom API.

Ein Beispiel für eine gängige Nutzererfahrung, die durch eine CourseWork-Integration ermöglicht wird, ist die Möglichkeit für Lehrkräfte, Inhalte auf Ihrer Website oder in Ihrer App zu finden, zuzuweisen und zu benoten:

1. Ein Lehrkraft-Nutzer meldet sich auf Ihrer Website an.
2. Die Lehrkraft sucht nach Inhalten oder erstellt sie, die sie mit ihrer Klasse teilen möchte. Die Lehrkraft klickt auf Ihrer Website auf eine Schaltfläche, um diese Inhalte an Google Classroom zu senden.
3. Ihre Anwendung sendet eine Anfrage an courses.courseWork.create. Im Text der Anfrage ist ein CourseWork-Objekt enthalten, das Folgendes enthält:
   • Die Zielkurs-ID.
   • Der Titel der Aufgabe.
   • Die Textbeschreibung der Aufgabe.
   • Eine link Material mit der URL zu den vom Lehrer ausgewählten Inhalten.
   • Optional die maximale Punktzahl, die für den ausgewählten Inhalt erreichbar ist.
4. In Classroom wird eine neue Aufgabe mit einem Linkanhang angezeigt. Der Link verweist auf die in der create-Anfrage angegebene URL. Abbildung 1 zeigt ein Beispiel.
5. Im Notenbuch von Classroom wird auch eine neue Spalte für die Aufgabe angezeigt, einschließlich der maximalen Punktzahl, sofern angegeben.
6. Die Schüler oder Studenten erhalten die Aufgabe und klicken auf link Material, um die angegebene URL in einem neuen Tab zu öffnen und die Inhalte auf Ihrer Website anzusehen oder zu erledigen. Optional: Stellen Sie Steuerelemente für die Abgabe der Aufgabe bereit.
7. Optional können Sie courses.courseWork.studentSubmissions.modifyAttachments bitten, einer Einreichung eines Schülers/Studenten Anhänge hinzuzufügen, z. B. eine Google Drive-Datei oder einen link Material, der auf die Arbeit des Schülers/Studenten auf Ihrer Website verweist.
8. Optional: Sie können courses.courseWork.studentSubmissions.patch bitten, die Note des Schülers/Studenten für die Aufgabe festzulegen.

Abbildung 1. Ansicht für Lehrkräfte beim Bearbeiten einer Aufgabe mit link Material, die über eine CourseWork-Integration erstellt wurde.

Alternativ können Sie courses.announcements.create oder courses.courseWorkMaterials.create aufrufen, um anstelle einer Aufgabe eine Ankündigung oder ein Kursmaterial zu erstellen. Ausführliche Beschreibungen der relevanten Classroom API-Aktionen finden Sie auf den Seiten Kursaufgaben erstellen und verwalten und Noten festlegen und aktualisieren.

Hinweise

Berücksichtigen Sie die folgenden Aspekte, bevor Sie entscheiden, ob eine CourseWork-Integration die richtige Wahl für Ihre Produktanforderungen ist.

• Sie müssen den Nutzer autorisieren und um seine Einwilligung bitten. Sie stellen im Namen des Nutzers API-Anfragen. Das bedeutet beispielsweise, dass Sie keine Kursarbeit in einem beliebigen Google Classroom-Kurs erstellen können, sondern nur in Kursen, die der autorisierte Nutzer unterrichtet.
• Sie benötigen eine Möglichkeit, mit der Nutzer einen Kurs auswählen können, um die Inhalte zu erhalten. Sie können courses.list verwenden, um eine Liste der Kurse aufzurufen, die der Nutzer unterrichtet, und dem Nutzer dann erlauben, einen oder mehrere der Kurse aus der Liste auszuwählen.
• Wenn ein Nutzer in Classroom auf ein link Material klickt, wird der Link in einem neuen Tab geöffnet. Ihr Server erhält keine Informationen von Classroom, wenn die URL geöffnet wird.
• Lehrkräfte können die Kursmaterialien unabhängig vom Entwickler ändern oder löschen. Das bedeutet, dass das Wissen eines Entwicklers über die Kursinhalte möglicherweise veraltet ist. Wenn Sie über Änderungen an Kursleistungen informiert werden möchten, können Sie Push-Benachrichtigungen für Änderungen an Kursleistungen einrichten.
• Lehrkräfte können in der Classroom-Benutzeroberfläche Kursmaterialien mit eingefügten Links zu URLs auf Ihrer Website erstellen. Auf diese Weise erstellte Kursmaterialien gehören ausschließlich der Lehrkraft. Sie können die Noten für eingereichte Aufgaben also nicht über die Classroom API einsehen, ändern oder festlegen.