Implementierungsstrategie

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 oder announcements.GetAddOnContextRequest auf Basis von itemType, um die Nutzerrolle zu validieren und den Wert supportsStudentWork 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.