Implementierungsstrategie

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

iFrame für die Suche nach Anhängen

Der iFrame zur Anhangserkennung ist die Landingpage für Lehrkräfte in Ihrem Add-on. Ergreifen Sie gegebenenfalls folgende Maßnahmen für diese Ansicht:

  • 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 für den Typ courseWork werden Antworten von Schülern/Studenten akzeptiert.

  • 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. Erwägen Sie in Bezug auf diese Ansichten die folgenden Maßnahmen zu ergreifen:

  • Holen Sie beim Öffnen eines iFrames die OAuth-Zustimmung des Nutzers ein und validieren Sie dann seine Rolle und die Anhangs-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 attachmentId dem Add-on bereits bekannt ist, rufen Sie die entsprechende UI für Anhänge auf.
  • 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. Zeigen Sie dann die entsprechende UI für Anhänge an.