Implementierungsstrategie

Auf dieser Seite erhalten Sie einen kurzen Überblick über die wichtigsten Interaktionen zwischen Ihrer Add-on-Webanwendung und der Add-ons API für Google Classroom.

iFrame für die Suche nach Anhängen

Der iFrame für die Suche nach Anhängen ist die Landingpage für Lehrkräfte in Ihrem Add-on. Sie haben folgende Möglichkeiten:

  • Zeigen Sie die Benutzeroberfläche für die Suche oder Erstellung von Inhalten an.

    Optional können Sie festlegen, ob für das Streamelement Antworten von Schülern oder Studenten akzeptiert werden sollen. So können Sie verhindern, dass die Lehrkraft Anhänge vom Typ „Aktivität“ hinzufügt. Prüfen Sie den Wert des Abfrageparameters itemType, der beim Öffnen des Add-on-Iframes übergeben wurde. Nur beim Typ courseWork sind Antworten von Schülern und Studenten zulässig.

  • Reichen Sie basierend auf den Auswahlen der Lehrkräfte eine oder mehrere create-Anfragen für Add-ons ein, um der Aufgabe Anhänge hinzuzufügen.

Andere iFrames

Der iFrame für die Schüler-/Studentenansicht, der iFrame für die Überprüfung der Schüler-/Studentenarbeit und der iFrame für die Lehreransicht dienen dazu, Inhalte für den Nutzer zu präsentieren, anstatt eine Classroom-Aufgabe zu ändern. Sie können folgende Maßnahmen in Bezug auf diese Ansichten ergreifen:

  • Wenn ein Iframe geöffnet wird, holen Sie die OAuth-Einwilligung des Nutzers ein und prüfen Sie dann seine Rolle und die Anhang-ID.
  • Wenn ein Iframe geöffnet wird, erstellen Sie ein courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest oder announcements.GetAddOnContextRequest basierend auf dem itemType, um die Nutzerrolle zu validieren.
  • Wenn der aktuelle Nutzer ein Schüler oder Student ist, ordnen Sie die submissionId aus der Antwort der Schüler-/Studentenarbeit zu. Dies ist erforderlich, um Noten zurückzugeben und Lehrkräften die Aufgaben von Schülern/Studenten im Benotungstool zu zeigen. Die submissionIds müssen in allen Ansichten übereinstimmen.
  • Wenn das Add-on die attachmentId bereits kennt, wird die entsprechende Benutzeroberfläche für Anhänge angezeigt.
  • Andernfalls muss der übergeordnete Beitrag dieses Anhangs aus einem anderen Beitrag oder Kurs kopiert worden sein. Verwenden Sie copyHistory, um die neueste Kopie zu ermitteln, die dem Add-on bekannt ist, und kopieren Sie die Einstellungen daraus, um ein neues entsprechendes Modell des Anhangs auf Add-on-Seite zu erstellen. Anschließend wird die entsprechende Benutzeroberfläche für Anhänge angezeigt.