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 Arbeit der Schüler oder Studenten. Dies ist erforderlich, um Noten und um Lehrkräften Aufgaben von Schülern/Studenten im Benotungstool zu zeigen die submissionIds Übereinstimmung bei 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.