Implementierungsstrategie

Diese Seite bietet einen kurzen Überblick über die wichtigsten Interaktionen zwischen Ihrem Add-on-Web und die 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 die Antworten der Schüler/Studenten auf das Streamelement akzeptiert werden. da Sie vielleicht verhindern möchten, dass die Lehrkraft den Aktivitätstyp Anhänge. Prüfen Sie den Wert des itemType-Abfrageparameters, der im die beim Öffnen des Add-on-iFrames übergeben wurde. Nur der Typ courseWork akzeptiert die Antworten der Schüler/Studenten.

  • Basierend auf der Auswahl der Lehrkraft eine oder mehrere create-Anfragen für Add-ons stellen bei Anhänge zur Aufgabe hinzufügen.

Andere iFrames

iFrames „Schüleransicht“, „Aufgaben von Schülern/Studenten ansehen“-iFrame und „Lehreransicht“ iFrame sind alle dazu gedacht, dem Nutzer Inhalte zu präsentieren, anstatt ein Element zu verändern. Aufgabe in Classroom. Erwägen Sie Folgendes: zu diesen Ansichten:

  • Holen Sie beim Öffnen eines iFrames die OAuth-Einwilligung des Nutzers ein und validieren Sie dann seine Rolle und die Anhangs-ID.
  • Wenn ein iFrame geöffnet wird, erstellen Sie einen courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest oder announcements.GetAddOnContextRequest basierend auf dem itemType-Objekt zur Validierung Nutzerrolle
  • Wenn der aktuelle Nutzer ein Schüler oder Student ist, verknüpfe submissionId aus der mit der Aufgabe der Schüler/Studenten. Dies ist erforderlich, um Noten und um Lehrkräften Aufgaben von Schülern/Studenten im Benotungstool zu zeigen die submissionIds Übereinstimmung in allen Ansichten.
  • Wenn das attachmentId dem Add-on bereits bekannt ist, blenden Sie das entsprechende Element ein. UI für Anhänge.
  • Andernfalls muss der übergeordnete Beitrag dieses Anhangs aus einem anderen Beitrag oder Kurs kopiert. Mit copyHistory ermitteln Sie, welche die dem Add-on bekannt sind, und kopieren Sie die Einstellungen daraus in Erstellen Sie auf der Add-on-Seite ein neues entsprechendes Modell des Anhangs. Gehen Sie dann so vor: entsprechende UI für Anhänge anzeigen.