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 Anhangserkennung

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:

  • Blenden Sie die Benutzeroberfläche für die Inhaltssuche oder -erstellung ein.

    Legen Sie optional fest, ob das Streamelement die Antworten der Schüler/Studenten akzeptiert. 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.

  • Je nach Auswahl der Lehrkraft können Sie eine oder mehrere create-Add-on-Anfragen stellen, um der Aufgabe Anhänge hinzuzufügen.

Andere iFrames

Die iFrames für die Schüler-/Studentenansicht, der iFrame der Aufgabenbewertung von Schülern/Studenten und der iFrame für die Lehrkräfteansicht sind dazu gedacht, dem Nutzer Inhalte 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/Student ist, verknüpfen Sie die submissionId aus der Antwort mit der Aufgabe des Schülers/Studenten. Dies ist erforderlich, um Noten bekannt zu geben und den Lehrkräften Aufgaben von Schülern/Studenten im Benotungstool anzuzeigen; die Übereinstimmung submissionIds für alle Ansichten.
  • 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. Ermitteln Sie mit copyHistory die aktuellste Kopie, die dem Add-on bekannt ist, und kopieren Sie die Einstellungen daraus, um auf der Add-on-Seite ein neues entsprechendes Modell des Anhangs zu erstellen. Zeigen Sie dann die entsprechende UI für Anhänge an.