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 TypcourseWork
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
oderannouncements.GetAddOnContextRequest
basierend auf demitemType
-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 diesubmissionIds
Ü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.