Diese Seite bietet einen kurzen Überblick über die wichtigsten Interaktionen zwischen Ihrer Add-on-Webanwendung und der Google Classroom Add-ons API.
Anhangerkennung – iFrame
Der iFrame für die Anhangerkennung ist die Landingpage für Lehrkräfte in Ihrem Add-on. Führen Sie in dieser Ansicht die folgenden Schritte aus:
- Wenn der iFrame für die Anhangerkennung geöffnet wird, erstellen Sie einen
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
oderannouncements.GetAddOnContextRequest
auf Basis vonitemType
, um die Nutzerrolle zu validieren und den WertsupportsStudentWork
zu erhalten. - Benutzeroberfläche zum Entdecken oder Erstellen von Inhalten anzeigen Sie können Anhänge von Aktivitätstypen, die auf dem Wert von
supportsStudentWork
basieren, aus der Startvalidierungsantwort weglassen. - Stellen Sie je nach Auswahl der Lehrkraft eine oder mehrere
create
-Add-on-Anfragen, um der Aufgabe Anhänge hinzuzufügen.
Andere iFrames
Mit den iFrames für die Ansicht der Schüler/Studenten, dem iFrame für die Aufgabenüberprüfung von Schülern/Studenten und dem iFrame der Lehrkräfteansicht sollen Nutzern Inhalte präsentiert werden, statt eine Classroom-Aufgabe zu ändern. Erwägen Sie die folgenden Maßnahmen in Bezug auf diese Ansichten:
Wenn ein iFrame geöffnet wird, holen Sie die OAuth-Einwilligung des Nutzers ein und validieren Sie dann seine Rolle und die Anhangs-ID.
- Wenn der aktuelle Nutzer ein Schüler/Student ist, verknüpfen Sie
submissionId
aus der Antwort mit der Aufgabe des Schülers/Studenten. Dies ist erforderlich, um Noten zu übermitteln und den Lehrkräften die Aufgaben von Schülern/Studenten im Benotungstool zu zeigen.submissionIds
stimmen in verschiedenen Ansichten überein. - Wenn
attachmentId
dem Add-on bereits bekannt ist, wird die entsprechende UI für den Anhang angezeigt. - Andernfalls muss der übergeordnete Beitrag dieses Anhangs aus einem anderen Beitrag oder Kurs kopiert worden sein. Verwenden Sie
copyHistory
, um die neueste Kopie des Add-ons zu ermitteln und die Einstellungen daraus zu kopieren, um ein neues entsprechendes Modell des Anhangs auf der Add-on-Seite zu erstellen. Zeigen Sie dann die entsprechende Benutzeroberfläche für Anhänge an.
- Wenn der aktuelle Nutzer ein Schüler/Student ist, verknüpfen Sie